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1. Introduction 


123 Flash Chat Server Software is a real-time, powerful, high performance chat 
server produced by TopCMM Software Corp. ( http://www.topcmm.com/ ) .This user 
manual contains clearly labeled diagrams and instructions for how to install, use, and 
administrate 123 Flash Chat Server Software for your own use. The demonstration 
version of 123 Flash Chat Server Software is a free way to test the paid version. The 
demonstration includes every feature of the full version, however, the user’s connection 
will be lost every ten minutes. 
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The latest information concerning 123 Flash Chat Server Software can be found by visiting 


http://www. 123flashchat.com. 
If you are interested in purchasing this software online, please go to 


http://www. 123flashchat.com/buy.html. Thank you! 


2.1 


Requirements 


Server Requirements 


2.1.1 Supported Platforms 


Windows 95/98/NT/ME/2000/XP/Vista 
Solaris/Sparc 2.6, 7,8,9 
Solaris/Intel 2.6,7,8,9 

Compaq Tru64 

IRIX 

HP-UX 10.20, 11 

AIX 4.3.x 

Linux Redhat 6.3, 7.1, 7.2, 7.3, 9 
Linux Caldera 

TurboLinux 

Mac OS Classic 8.1 - 9.X 

Mac OS X 10.0 - 10.1 

Mac OS X Server 


2.1.2 Hardware requirements 


123 Flash Chat Server Software will be compatible with most server hardware. 


The minimum hardware requirements are as follows: 


586/200 MHz or faster processor 
64 MB of RAM or more 
100 MB free hard disk space or more 


Dedicated PII/400 MHz with 256 MB RAM is eligible to handle 500 or more concurrent users. 
Adding extra RAM and processors will improve the performance of 123 Flash Chat. 


2.1.3 Java Virtual Machine(JVM) Requirements 
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A Java Virtual Machine (JVM), or a Java Developer Kit (JDK), fully compliant with the Sun 
J2SDK 1.4.x is required to run the 123 Flash Chat server. We recommend J2SDK 1.4.2 or a 
higher version. 

For the current version of JDK, visit http:///ava.sun.com/. 


Note: The Windows and Linux versions of 123 Flash Chat Server Software now include the 
Sun J2SDK 1.4.2 so it won't be necessary to install JDK again. 


2.1.4 Port requirements 


123 Flash Chat Server Software needs at least ONE free port. The default port is: 51127 

123 Flash Chat Server Software can listen to two ports simultaneously to guarantee the 
accessibility: 

a low one («1024) and a high one (1024~65535). 

To ensure your users don't have to configure a firewall before accessing 123 Flash Chat, the 
low port can be set to 80 or 443, since it is allowed by most users' firewalls. 

But remember, ports below 1024 can only be accessed using flash player 7 or 8. That's why 
you may set a high port (1024~65535) to serve lower version flash player. 

123 Flash Chat Server Software has a built-in web server JUST for testing purpose. The 
default port value for this web server is 35555. 

For more detailed instructions on ports, please refer to the: Server Configuration Section of 
this guide. 


2.2 Client Requirements 


2.2.1 Hardware Requirements 


W 586/166 MHz or faster processor 
W 64 MB of RAM or more. 


2.2.2 Flash Player Requirements 


The client will need Macromedia Flash Player 6 or above to use the flash chat client. 

If users do not have flash player 6 or higher installed, they will be notified of these 
requirements and automatically directed to Macromedia Download Center to download 
Macromedia Flash Player for free. 


3. Installation 
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Two main versions of 123 Flash Chat Server Software are available, one is for Windows 
and the other for Linux. Both include J2SDK1.4.2. 


For operating systems other than Windows or Linux, before installing 123 Flash Chat 
Server, J2SDK1.4.x must be downloaded by visiting http://java.sun.com and installed. 


The installation will include two parts: 


1. Installing the chat server 
2. Configuring a web server and embed the chat client to your webpage 


3.1 Overview the files: 


It contains the following folders: 


e /client 
€e ad 
€ banner 


e  flashEmotion 


€ help 
@ skin 
€ /doc 
€ /server 
€ data 
B default 
€ logs 
€ members 
€ message 
€ rooms 
€  userinfo 
€ etc 
E groups 
€ default 
€ database 
€ lang 
@ skin 
€  server.xml 
€  client.xml 
e lib 
€ logs 


€ wrapper win32 
€ /readme.txt 
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3.2 Installing the Chat Server 


3.2.1 Windows NT/2k/XP/2003 


Follow the steps below to install the latest Windows version of 123 Flash Chat Server 


1. Download the latest Windows version of 123 Flash Chat Server Software at: 
http://www. 123flashchat.com/download.html, get the file: 123flashchat.exe 


2. Double click “123flashchat.exe’. It will take a few minutes to install just following the simple 


instructions in it. 
ie Setup - 123 Flash Chat Server 6.7 


Welcome to the 123 Flash Chat 
Server 6. 7 Setup Wizard 


This will install 123 Flash Chat Server 6.7 on your computer. 


|t is recommended that you clase all other applications before 
continuing. 


Click Next to continue, or Cancel to exit Setup. 


3. After 123 Flash Chat Server has been installed, wait a few seconds while 123 Flash Chat 
Server as a Windows NT service is automatically started( Usually you don't have to start it 
manually). 


123 Flash Chat Server as a Windows NT service will automatically load and start after each 
reboot of your server computer. 
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ie Setup - 123 Flash Chat Server 6.7 


Completing the 123 Flash Chat 
Server 6.7 Setup Wizard 


Setup has finished installing 123 Flash Chat Sever 6.7 on your 
computer. The application may be launched by selecting the 
installed icons. 


Click Finish to exit Setup. 


Server has been installed and started, star: a client to test 


4. Start the chat server. 


This can be done by starting the server in service mode or console mode, if it was stopped 
before. These modes are explained below: 


a) Starting in service mode: 
(In the Windows system) 


start->program->123 flash chat server 6.0 -> Server->start 123 flash chat server. 


> Start 123 Flash Chat Server 


Starting the 123 Flash Chat Server 6.7 service... 
123 Flash Chat Server 6.7 started. 


If an error occurs, probably the chat server is already started before or there is a problem with 
the server configuration. To check what type of error it is, please start in console mode. 


b) Starting in console mode: 
(In the Windows system) 
start->program->123 flash chat server 6.0->control->start 123 flash chat server (console mode). 


Usually you will see something similar to the screen below: 


TopCMM Software 
http://www. 123flashchat.com 


123 Flash Chat User Manual 
2007-10-26 
Pages: 9 of 81 


T i 7 
tari ?3 Flash Chat server(C ote mod mm! X! 


—— | 


d —>->->-> www.123flashchat.com <-—<-<-< 

Welcome to try 123 Flash Chat Server software! 

This is a demo version of 123 Flash Chat Server 6.7 Chuild 20070711» 
Demo version vill disconnect the user after logging in for 18 minutecf 
Get the full version: http://www.123f lashchat .com/buy. html 

ee —>->->-> www.123flashchat.com &-4-4-4 -2-2———— 


Starting the server 
Set System Timezone GMT+8 
Loading ip-to-country data ... 


Loading connection policy 
Starting http server... 


Starting the tcp server 
Starting the http server on: 8.8.0.0/80.0.0.0:35555 
Start Check Chat Time 
Starting the chat server on: 8.0.0.0/80.0.0.0:5112"? 
123 Flash Chat Server has been Started! 
ou can open this url to test: http://192.168.0.100:35555 


Console mode is helpful to check error details. 
Console mode does not need to be used unless there is a problem with the process of starting 
the chat server. After fixing the problem, it is recommended to stop chat server and start again 


in service mode. 
5. To stop chat server: 


a) If you are in service mode, please stop the server in the following way: 
start->program->123flash chat server 6.0->server->stop 123 flash chat server. 
b) If you are in console mode, please stop the server by simply closing the pop-up DOS window. 


Stopping the 123 Flash Chat Server 6.7 service... 
wrapper 123 Flash Chat Server 6.7 stopped. 
Press any key to continue . . . m 


6. To restart chat server: 


a) If you are in service mode, please restart the server in following way: 
Start->program->123 flash chat server 6.0->server->restart 123 flash chat server. 
b) If you are in console mode, please close the DOS window firstly, and restart the server in 


following way: 
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start->program->123 flash chat server 6.0->server-> restart 123 flash chat server 


Note: After configuring the server parameter manually, you have to restart the chat server to make 


the changes effective. 


Note: Windows 98 and Windows ME do not support NT service. If you need to run the chat 
server on a Windows 98 or Windows ME server you should open Notepad to create a file with 


following code (in one single line): 


jre\bin\java -classpath 
“jre\lib\sunrsasign.jar;jre\lib\rt.jar;jre\lio\plugin.jar;jre\lib\jsse.jar;jre\lib\jce.jar;jre\lib\charsets.jar;lib 
\fcserver.jar;lib\moderator.jar;lib\log4j.jar;lib\xerces.jar;lib\jdom .jar;lio\mysql.jar” 
com.topcmm.jchat.FCServer 


Save it as a *.bat file to 123flashchat installed directory, for example, start98.bat, then open 
DOS window: 

cd «123flashchat installed directory» server 

start98.bat 


3.2.2 Windows Vista 


If you got an error message "wrapper | OpenSCManager failed" when you start, stop or 
restart the chat server program, you can right-click the program you wish to run, and 
select the option "RunAsAdministrator" to run the program successfully. 
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1.If you are in a local Linux console window, please skip this step. 

If you need to remote control Linux server, then please telnet or SSH to your Linux server first 
with SSH/telnet client software like Putty. Putty can be downloaded for free from: 
http://www.chiark.greenend.org.uk/-sgtatham/putty/download.html 


Then login to your server as shown below: 
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ex PuTTY Configuration 


Category: 


=) Session Basic options for your PuTTY session 

Logging 
Terminal 

Keyboard Host Name (or IP address) 
Bell www yourhost.com 
Features 

=) Window 
Appearance 
Behaviour 
Translation 
Selection 
Colours YourHost 


= Connection Default Settings 
Proxy hostl 


Telnet hostlÜü 
Rlogin hostl 1 


Specify your connection by host name orIP address 


Protocol: 
C) Raw CO Telnet O Rlogin 


Load, save or delete a stored session 


Saved Sessions 


Auth hast3 
Tunnels host4 
Bugs 


Close window on exit: 
(OAlways | (ONever (8) Only on clean exit 


ichat.com's password: 


[flashchat@hostiO flashchat ]$ 


2.Download the latest Linux version of 123 Flash Chat Server Software at: 


http://www. 123flashchat.com/download.html, 
Select the file: 123flashchat.tar.gz 


You can download it by using this command: 
$ wget http://www. 123flashchat.com/download/123flashchat.tar.gz 
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3.Uncompress the 123flashchat.tar.gz 
$ tar zxf 123flashchat.tar.gz 
4.Start the server manually: 
$ cd 123flashchat/server 
$ ./fcserver.sh start 
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5. Stop the server manually: 
$ ./fcserver.sh stop 


6. Restart the server manually: 
$./fcserver.sh restart 
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7. How to auto start chat server after rebooting your server? 
It can be done following the steps below: 
Step 1: 
Modify "fcserver.sh", find the FCSERVER HOME section, and configure the directory of 
"fcserver.sh". 
For example, if you uncompress the 123flashchatserver.tar.gz into /usr/local/123flashchat, 
make sure "fcserver.sh" is in the directory of /usr/local/123flashchat, then remove the “#” 
before the two rows below in "fcserver.sh": 
FCSERVER_HOME=/usr/local/123flashchat/server 
export FCSERVER_HOME 


Step 2: 
Modify /etc/rc.local file, add one row: 


/usr/local/123flashchat/server/fserver.sh 
Just replace "/usr/local/123flashchat/ “ with your FCSERVER_HOME value. 


1. Download the latest version of 123 Flash Chat Server Software(without JVM) from: 
Select the file: 123flashchat_s.tar.gz 


2. Uncompress the 123flashchat s.tar.gz 
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$gzip -d 123flashchat s.tar.gz 
$ tar xf 123flashchat_s.tar 


3. Start 123 Flash Chat Server: 
$./fcserver mac.sh start 


4. Stop 123 Flash Chat Server: 
$./fcserver mac.sh stop 


5. Restart 123 Flash Chat Server: 
$./fcserver mac.sh restart 


3.2.5 Other Unix Operating System 


1: Download the latest version of 123 Flash Chat Server Software (without JVM) from: 


http://www. 123flashchat.com/download.html, 
Select the file: 123flashchatserver_s.tar.gz 


2. Uncompress the 123flashchatserver_s.tar.gz 
$ gzip -d 123flashchatserver s.tar.gz 
$ tar xf 123flashchatserver s.tar 


3. Make sure Sun j2sdk 1.4.x or a newer version is already installed in your system. If it 
is not, download it from: http://java.sun.com/ 


4. Set the Java variable and edit the system PATH variable in /etc/profile: 


JAVA HOMEz/usr/local/j2sdk1.4.x;export JAVA HOME 
CLASSPATH=$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar 
PATH=$PATH:/usr/java/j2sdk1.4.x/bin;export PATH 


5. Start 123 Flash Chat Server. 
Remember to type all code below in a single line. 


$ java -classpath CLASSPATH: lib/fcserver.jar:lib/moderator.jar:lib/changenick.jar: lib/ 
invisibleadmin.jar:lib/serverapi.jar:lib/robotmessage.jar:lib/fclib.jar:lib/log4j.jar:lib/jdom 
.jar:lib/xerces.jar com.topcmm.jchat.FCServer & 


Note: For “Sun Solaris”, we strongly recommend the patch for J2SDK to be installed before 
installing the 123 Flash Chat Server Software. This will ensure the stability of the multi- 
thread Java application, 

The patch can be obtained from: http://sunsolve.sun.com/pub-cgi/show.pl?target=patches/J2SE 
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Tip: If you are still experiencing problems and require help with installing the Java software, 
please contact your system administrator. Alternatively you can contact us via email at 
support @ 123flashchat.com 

Please make sure to include the details of your operating system. 

If you have purchased 123 Flash Chat Server Software, please also include your name, 
purchase email and user license, we'll provide a preferential support to buyer. Those who 
have purchased the unlimited user license version of 123 Flash Chat will get priority and 
will also receive a lifelong upgrade and technical support for free. 


3.3 Web server 


123 Flash Chat Server Software includes a temporary web server JUST for testing purpose. 
But when you launch the 123 Flash Chat Server officially, a professional web server is 
strongly recommended, such as Apache, IIS, etc. 


To integrate the chat client to a web server other than the built-in web server, please follow 
the steps below: 


a) copy the “client” folder 
Copy the “client” folder to the web directory of your web server, but keep in mind: 


Note: DO NOT copy the "server" folder to protect it from being downloaded by chatters, 
which is very insecure. The “server” folder should already be securely installed on the 
web server automatically so far in the installation process. 


b) edit client.xml 

Please leave the host value to 
123flashchat.swf file) are located on the same server. 

If the SWF file is on another web server, then you should set the host value according to the 


aD 


if the chat server and the web server (which hosts the 


chat server domain name or IP address. 
The port value in client .xml should be identical with the one in fcserver.xml. 
For advanced connection configuration, please refer to: 


http://www. 123flashchat.com/howto configure connection.html 


3.4 Insert code 


So far 123flashchat.swf is supposed to be already in your web directory. You can insert 
123flashchat.swf into your webpage (static or dynamic) and you have two options: The Easy 
Way or the Advanced Way. In the latter case you can not only insert the flash chat client into 
the web page but also remove the border of the flash in IE and make the flash client 
automatically run. 
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3.4.4 Easy Way 


Just insert following code into the desired place of your web page. 
<DIV idz"flashchat"» 

«OBJECT classid=“clsid:D27CDB6E-AE6D-11cf-96B8-444553540000” 
codebase=“http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=6,0,19, 
0" WIDTH="634” HEIGHT=“476” id=“toocmm_123flashchat”> 

<PARAM NAME=movie VALUE-"123flashchat.swf"- 

<PARAM NAME=quality VALUE=“high’> 

<PARAM NAME=“menu’ value=“false”> 

<EMBED src="123flashchat.swf” quality=high menu=false WIDTH="634” HEIGHT="476” 
TYPE=“application/x-shockwave-flash” 
PLUGINSPAGE=“hitp:/Awww.macromedia.com/go/getflashplayer” scale=“noscale” 
name=“topcmm_123flashchat” swLiveConnect=“true”></EMBED> 

</OBJECT> 

</DIV> 


Above code is available in the sample webpage which you will get after the installation -> Chat Test. 


3.4.2 Advanced Way 


We have to bother to insert advanced code only because Microsoft has shipped a new version of its IE 
browser to permanently change the way multimedia content is rendered on Web pages. Otherwise the 


Flash chat client will have an ugly border and won’t auto-run until the user click to activate it first. 


A white paper detailing the ActiveX changes has been published on the MSDN. 


Also here: http://www.adobe.com/devnet/activecontent/articles/devletter.html#otheractivecontent 


The major difference is now you must include 123flashchat.js which contains the *openSWF" method, 
with this method, 123flashchat.swf URL, width and height can be defined. 


/[The following code should be inserted between the HTML tag <head> and </head>. 
«script language-"javascript" src=“123flashchat.js”></script> 

/[The following code must be inserted between the HTML tag «body» and </body>. 
«script language=“javascript’> 

openSWF(23flashchat.swf',634', 476); 


</script> 
<noscript> 
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<DIV idz"flashchat"» 

«OBJECT classid=“clsid:D27CDB6E-AE6D-11cf-96B8-444553540000” 
codebase=“http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version 
=6,0,19,0” WIDTH="634” HEIGHT="476” id=“toocmm_123flashchat’> 
<PARAM NAME=movie VALUE=“123flashchat.swf’> 
<PARAM NAME=quality VALUE=“high’> 
<PARAM NAME-"menu" value=“false”> 
<EMBED src=“123flashchat.swf” quality=high menu=false WIDTH=“634” HEIGHT="476” 
TYPE=“application/x-shockwave-flash” 
PLUGINSPAGE=“hitp:/Awww.macromedia.com/go/getflashplayer” scale=“noscale” 
name=“topcmm_123flashchat” swLiveConnect=“true”></EMBED> 
</OBJECT> 
</DIV> 


Note: Please remind your users to enable javascript code in their browsers to allow 
“4 23flashchat.js” to work. Details: 


https://www.google.com/adsense/support/bin/answer.py ?hl=en&answer=12654 


If the webpage, the 123flashchat.js and the 123flashchat.swf are in the same folder, then just 
paste above code into your webpage would work. 


If on the same server but different folder, then "init root" shall be appended. 
Paste above code to your page and replace the “123flashchat.swf” with this: 
./another directory/123flashchat.swf^init root-../another directory/ 


If the 123flashchat.swf is on another domain, the parameter "init root" is also indispensable 
to ensure 123flashchat.swf can find the relevant files to load: 


Paste above code to your page and replace the “123flashchat.swf” with 
http://www.another domain.com/chat/123flashchat.swf?init root-http://www.another domain. 


com/chat/ 


Resize Chat Client 


Meanwhile, you can also control the size of the 123 Flash Chat flash client in the HTML code. 
Find: WIDTH="634” HEIGHT="476”, replace the values with the expected width and height. 
And replace values of the second parameter (WIDTH) and the third parameter (HEIGHT) of 
the openSWF() method with the expected width and height. 


Technically the smallest size is 550*250, and for the width, we recommend it be no less than 
400 pixels. You can if you prefer, remove the logo, buttons and other decorations to make it 
even smaller. For Client Configuration details, please refer to: 4.2 Client Configuration 
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Append init xxx arguments to 123flashchat.swf: 


There are some parameters could be appended to the “123flashchat.swf”, for the details of 
parameters, please refer to 7.2 Client Parameters. 


When you use the openSWF method, there are two way to append parameters to the 
“4 23flashchat.swf” 
1. Append after *123flashchat.swf" directly: 
openSWF(‘123flashchat.swf?init_lang=en&init_skin=standard’,’634’,'476’); 


A full sample: 


<script language=“javascript” src=“123flashchat.js”></script> 

<script language=“javascript’> 
openSWF('123flashchat.swf?init_lang=en&init_skin=standard ','634','476'); 

</script> 

<noscript> 

<DIV id="“flashchat”> 

<OBJECT classid=“clsid:D27CDB6E-AE6D-11cf-96B8-444553540000” 
codebase=“http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#ver 
sion=6,0,19,0” WIDTH="634” HEIGHT="476” id="topcmm_123flashchat”> 

<PARAM NAME=movie VALUE=“1 23flashchat.swf?init_lang=en&init_skin=standard “> 
<PARAM NAME=quality VALUE=“high’> 

<PARAM NAME-"menu" value=“false”> 

«EMBED src=“123flashchat.swf?init_lang=en&init_skin=standard “ quality=high 
menu=false WIDTH=“634” HEIGHT=“476” TYPE-"application/x-shockwave-flash" 
PLUGINSPAGE=“hitp://www.macromedia.com/go/getflashplayer” scale=“noscale” 
name=“topcmm_123flashchat” swLiveConnect=“true”></EMBED> 

</OBJECT> 

</DIV> 


2. Use the predefined parameter: (recommended) 
init_lang="en”; 
init_skin="standard” 
openSWF(‘123flashchat.swf’,’634’,’476’); 


A full sample: 


<script language-"javascript" src=“123flashchat.js”></script> 
<script language=“javascript’> 


init_lang="en”; 
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init skinz"standard"; 

openSWF('123flashchat.swf ','634','476'); 

</script> 

<noscript> 

<DIV id=“flashchat”> 

<OBJECT classid=“clsid:D27CDB6E-AE6D-11cf-96B8-444553540000” 
codebase=“http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab 
#version=6,0,19,0” WIDTH="634” HEIGHT="476” id=“topcmm_123flashchat’> 
<PARAM NAME=movie VALUE=“1 23flashchat.swf?init_lang=en&init_skin=standard 


> 

<PARAM NAME=quality VALUE=“high’> 

<PARAM NAME-"menu" value=“false”> 

«EMBED src=“123flashchat.swf?init_lang=en&init_skin=standard “ quality=high 
menu=false WIDTH=“634” HEIGHT ="476” TYPE-"application/x-shockwave-flash" 
PLUGINSPAGE=“hitp://www.macromedia.com/go/getflashplayer” scale=“noscale” 
name=“topcmm_123flashchat” swLiveConnect=“true”></EMBED> 

</OBJECT> 

</DIV> 


4. Configuration 


4.1 Server Configuration 


By default, all configuration for the chat server is controlled by two files: 

1. fcserver.xml This is located at: 

<123flashchat installed directory>/server/etc/fcserver.xml 

2. server.xml It is located at: 

<123flashchat installed directory»/server/etc/groups/default/server.xml 

You can also access both files from Windows start menu if you’re using Windows system. 


4.1.1. fcserver.xml 


4.1.1.1 Connection Configuration 


Open the configuration file fcserver.xml 

In the Connection Section, you can set two servers and listen to two ports. 
primary-server 

secondary-server 


There are four reasons as to why there is a second server port option. They are listed below: 
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1) Any version before Flash Player 7 only allows access on a high port (1024-65535) due to 
security reasons, while a low port is forbidden. If you are okay with high port you will not 
need to set secondary-server. However if you need to set port lower than 1024, you will 
need a secondary-server. 

2) If the port of your primary-server is lower than 1024 like 80, then only users with Flash 
Player 7 or newer versions will be able to access the chat while users with flash player 6 
cant. 

In this case a secondary-server will be necessary. The port for the secondary server 
should be greater than 1024, which will allow users with an earlier version of Flash Player 
to access chat. 

3) If you are going to set a high port for your primary-server, then usually you will not need 
a secondary-server. You will be able to leave the option as default: enablez"off". 

4) Using two servers with two ports is just a temporary solution while some users are still 
using Flash players earlier than version 7. 

When Flash player 7 or higher version becomes mainstream, we will take off the 
secondary-server for future versions of 123 Flash Chat. 


To help understanding, please study two tables below: 


Parameter High port (1024-51127) Low port («1024) 
>=Flash player 7 v v 
Primary server 
v x 
secondary server 
Table1 
Parameter High port (1024-51127) Low port («1024) 
>=Flash player 7 v v 
Primary server 
v x 
(unnecessary) 
Table2 


To modify the Parameters, please refer to the table below: 


Parameter Type Default Value Description 

port Number 51127 The server port must be identical with the 
port value in client.xml. 

Set the Server address. 

A default “*” means the chat server will 
bind to all IP addresses of your server. 
The host value in client.xml can be a 
random IP address or any domain name 
which points to this IP address. Either 
way, Clients will be able to connect to the 
server. 

If you set IP address of the server to the 
specific IP address of your server, then 
the chat server will only bind to this IP. 
This will mean that in client.xml, to 
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connect the chat server, you can only use 
this specific IP address or the domain 
name which points to this IP address. 


http-server: 


To modify the Parameters, please refer to the table below: 


Parameter Type Default Value Description 


port Number | 35555 The server port must be identical with the 
port value in client.xml. 

Set the Server address. 

A default “*” means the chat server will 
bind to all IP addresses of your server. 
The host value in client.xml can be a 
random IP address or any domain name 
which points to this IP address. Either 
way, clients will be able to connect to the 
server. 

If you set IP address of the server to the 
specific IP address of your server, then 
the chat server will only bind to this IP. 
This will mean that in client.xml, to 
connect the chat server, you can only use 
this specific IP address or the domain 
name which points to this IP address. 


* 


ip String 


enable String On Enable or disable the http server 
documentRo | String . /client The directory out of which you will serve 
ot your documents. By default, all requests 
are taken from «123flashchat installed 
directory>/client directory. 

maxUPLoad | Number 1024 Setting the max file can be uploaded to 
Size the server, if the value less than or equals 
to 0, this means the server will not accept 
any upload files. 


cross-domain-policy 


123 Flash Chat Server start using the cross-domain-policy to ensure security. 
<cross-domain-policy> 


oa” 


<allow-access-from domain=“*” /> 
</cross-domain-policy> 


By default it permits access to the connection originating from any domain. 


To limit access from a specific domain name, you can configure your server in the following 
way: 
<cross-domain-policy> 
<allow-access-from domain=“www.mydomain.com” /> 
</cross-domain-policy> 
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To allow all URLs on mydomain.com to be accessible, you can configure your server in the 
following way: 
<cross-domain-policy> 


ok 


<allow-access-from domain=“*.mydomain.com” /> 


</cross-domain-policy> 


To allow multiple domain names to be accessible you can configure your server in the 
following way: 
<cross-domain-policy> 

<allow-access-from domain=“www.myfriendsdomain.com” /> 


ok 


«allow-access-from domain=“*.mydomain.com” /> 
<allow-access-from domain=“11.22.33.44” /> 


</cross-domain-policy> 


max-connections-per-ip 

<!-- max-connections-per-ip 

Connection limit of each IP. By default it is “10”. 

If configure it to "0", then one IP can login unlimited connections, this can be used for 
performance test. --> 

<max-connections-per-ip>10</max-connections-per-ip> 


In current version, the cross-domain-policy is now enhanced in this way: 

not only all connections originating from domain which is not in the allow-access list is 
forbidden, those connections originating from local computer by launching SWF file are now 
denied, too. 

Only connections from allow-access list can access chat. 

(Of course you can set it to permit access from any domain.) 


4.1.1.2 Global Configuration 


Open the configuration file fcserver.xml 
In the Global Section: 
To modify the Parameters, please refer to the tables below: 


Parameter Type Default Value Description 

message- Number 10 It deals with messages. 

handle- To handle high frequency messages with over 

workers 1000 chat users in one room, please set it to a 
higher value. Normally you will not need to 
change it. 

listen- Number 5 If the maximum number of users is over 1000, 

workers please configure it with larger number. 
Normally you will not need to change this. 

http-listen- Number 5 The value of http-listen-workers determine on 

workers the purpose of the http server. If you use the 
http server to receive the upload files mainly, 
please set it to a bigger value (about 20-50), if 
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you use the http server act as a proxy server, 
setting the value equals to the listen-workers is 
enough. 


http- Number 10 It can deal with messages from the HTTP 

message- server. 

handle- To handle high frequency messages from your 

workers HTTP chat server with over 1000 users, please 
set it to a higher value. Normally you will not 
need to change it. 

max- Number 10000 The user maximum in all rooms will be limited 

connection by the license you've purchased. 

user-timeout | numbers 300 If a still logged-in user does not send a request 
to the chat server for a predefined period of 
time, chat server will stop serve him and the 
connection will be cut. 
For example: 
If a user clicks another URL in their current 
browser instead of quitting 123 Flash Chat first, 
their connection will be cut by this setting. But if 
the 123 Flash Chat user is inactive inside their 
current browser their connection will still be 
kept as the flash client will send request to the 
chat server at intervals to keep the connection 
alive. 

user-idle- numbers 300 A user will be identified as being in “idle” status 

timeout when they have not sent a message for a 
defined period of time. The units of measure 
are seconds. 

user- numbers 20 A user will get “failed to log in” error message 

connection- when it exceeds the predefined period of time 

timeout to try to connect to the chat server. 

data-path String data Sets the folder name in which following data 
files are stored: member folder; ban-ip list; ban- 
user list, etc. 

admin-logs- string logs Name of the folder of admin log data files. 

path 

max- Number 10 Connection limit of each IP. By default it is *10". 

connections- If configure it to “O”, then one IP can login 

per-ip unlimited connections, this can be used for 
performance test. 

time-zone Number 0 Set your local time zone. between -12 to 12. 


For example, -5: GMT-5 , 8: GMT+8 
Default is 0: GMT 


4.1.2 Server.xml 


4.1.2.1 General Configuration 


To modify the Parameters, please refer to the table below: 


Parameter 


Type 


Default Value 


Description 
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enable-guest- | On/Off On Allow unregistered guest to log in or not. 
login 
Enable-user- | On/Off On Allow new user to register 
register 
max- Numbers 10000 User Maximum in all rooms of current group 
connection simultaneously. 
Max-userid- Number 32 Maximum length of user id when registering 
length 
max-passwd- | Number 32 Maximum length of password when registering 
length 
max-email- Number 128 Maximum length of email address when 
length registering 
max- Number 512 Maximum length of each message. 
message- 
length 
Max-cached- | Number 5 Shows the last conversation in a newly 
message- opened room and defines how many latest 
entry messages will be displayed. 
Max-post-row | Number 5 Maxium row of each message. 
Integrated- String None 123 Flash Chat can integrate your existing user 
other- database, like that of your forum or portal 
database system. 
123 Flash Chat integrates phpBB, PHPNuke, 
PostNuke, AspNuke, etc. 
A forum which doesn’t have a database can 
not be integrated. 
The modes of IntegratedOtherDatabases are: 
None — not using an integrated database to 
authorize a user 
Mysql - using a mysql database 
Oracle — using an oracle database 
ODBC - using ODBC DSN to connect a 
database 
Common - using all kinds of databases, 
advanced setting 
URL - using a web URL to authorize a user's 
login information. 
Eg: 
«IntegratedOtherDatabase mode-"Mysql"» 
If itis set to "None", when a new user clicks 
"register", they will be registered in the chat 
room original register window 
If set to “Mysql”, "Oracle" or “common”, then 
when a new user clicks "register", a new 
window will pop up and they will be directed to 
another URL which is pre-set in client.xml. 
Auth-url string / You can just leave it blank or even delete this 


line. It is only necessary when "integrated- 
other-database" is set to URL. 


It means the URL you use to authorize your 
users must have two arguments. One is 
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the %usename%, the other is 
the %password%. 


Eg: 


«auth- 
url>http://www. yourhost.com/login_chat.php?us 
ername=%username%&amp;password=%pass 


word%</auth-url> 


In this URL, *&amp;" means the character "& in 
xml. 


That is to say, when the user logs into your 
website by inputing their username “myname” 
and their password “mypassword”, and click 
“chat” link or button, the chat server will visit 
“http://www.yourhost.com/login_chat.php?user 
name=myname&password=mypassword” in 
order to get the login information and will 
output numbers between 0 to 7, each with a 


different meaning. 


0 — login successfully; 

1 — wrong password; 

2 — the username can't be used; 

3 - login error, e.g. error in connecting 
database; 

4 — username does not exist; 

5 — successfully login as the administrator; 
6 — guest login not allowed; 


7 — username banned . 


talk-interval numbers 1000 This is the shortest pause ( in milliseconds) 
between two utterances. 
This prevents screen flooding. Eg: 1000 = 1 
second. 

Kick-ban- numbers 15 Specifies a time period to ban a user's 

timeout username and IP address after he has been 


‘kicked out’. Unit: minute 
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note: a user will only be banned from the 
current room but not from other rooms. 

If you set it to "0", there's no "ban" 
accompanied with "kick". 


Site-key string This is the code to validate your website. It 
must be the same as the siteKey value in 
client.xml, otherwise the client will not be able 
to connect to your chat server. 


moderatorSe | On/Off Off Enable the moderator users have permission to 
elP check others IP address. 


4.1.2.2 User Configuration 


Open the configuration file: default. xml 


In the user section, you can configure «admin» and <ReservedUserName>. 


To add an administrator, just add one line in the Users -> admin Section: 

«user name-"admin" passwd=“test” md5=“off’/> 

or: 

«user name=“admin” passwd=“098f6bcd4621d373cade4e832627b4f6” md5=“on”/> 


Parameters of admin configuration: 


Parameter Type Default Value Description 
name string username of the administrator name 
: Password of the administrator can be 
passwd string encrypted by MDS or not. password 
If the password is not encrypted it 
needs to be set as: md5=“off”. 
mg sing If encrypted it needs to be set as: mag 
md5=“on”. 


Multiple administrator accounts can be set up, however for security reasons, it is 
recommended to appoint only one administrator and to designate multiple moderators for 
different rooms who have less ‘power. 


To add a reserved username, just add one row in 
<ReservedUserName> tag: 
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2. error log 
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One log file is generated for one day. The main log always records the current days logs. 


The history log automatically adds a postfix of the date. 


For example: access.log, access.log.2006-5-8, access.log.2006-5-7, 


file-name 


Parameter Type Default Value Description 
logs-path string logs Set the directory of data files 
access-log string access.log Set the filename of the access log 
Error-log string error.log Set the filename of the error log 
message logs 
Parameter Type Default Value Description 
logs-type string html Define the type of log to be html 
or plain text. 
1. text file. 
sample: **.log 
2. html file. 
sample: **.html 
public-message- string Set the directory of public 
path message 
public-message- string on Enable or disable to save the 
file-name->enable public message. 
public-message- string Set the root ur of public 
root-url message. 
public-message- string public Set the filename of the public 
file-name message log 
public-message- string Off Enable or disable to show the 
button public message button in client 
side, which will display in the chat 
history panel. 
private-message- string Set the directory of private 
path message 
private-message- string on Enable or disable to save the 
path ->enable private message. 
private-message- string private Set the filename of the private 


message log 
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4.1.2.4 FilterWords Configuration 


Inappropriate Words may need to be filtered from a conversation. 

If you want to substitute a word, please add one row in the tag below: «FilterWords» in 
<123FlashChatServer installed dir>\server\etc\groups\default\server.xml. 

Then set the substitute in the following tag: 

«FilterWords replace=“your substitute" 


For example: 

«FilterWords replace="***"> 
«filter»fuck«/filter 
<filter>shit</filter> 
</FilterWords> 


filter string Bad words needed to be filtered. 
replace string ii Set the substitute to replace the 
filtered words. 


kkk » 


Partial filter is also enabled, such as: “fuckyou” will be filtered as “***you”. 


4.1.2.5 robot-message 


Scheduled automatic ‘robot’ message(s) can be defined, to be broadcast in certain 
room(s) within certain intervals. This can be used for Site News, Advertisement, etc. 
Check details 


enable On/off On Enable or disable chat bot. 

activerooms string i Active rooms for all chat bot 
messages. 

interval number 10 The interval of rotate chat bot 


messages (seconds) 


message String / The robot message content 


4.1.2.6 server-api 


The 123 Flash Chat server can receive commands sent by third party applications and 
can send its data to the application or can operate on the chat server accordingly. By 
default it is set to be "On"- enabled. 
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Parameter 


Default Value Description 


auth-password 


3874-3459-9293-2194 Only command with the right 


key( password) will be authorized by 
the chat server and will be effective. 


allow-access-from-ip 127.0.0.1 


Only command from this IP is 
legitimate. 

If set to “*”, then commands from all IP 
address are valid. which is insecure. 


4.1.2.7 Modules 


With following optional modules, the chat can be greatly enhanced. 
These are included in the demonstration version for test but are not included in the 


standard full version by default. 


Specific module(s) can be purchased if required. 


Module 
name 


Default Value 


Introduction 


moderated- 
chat 


On 


With moderated-chat module enabled, the questions 
submitted by participants can't go public unless the 
Moderator or Admin approves/passes it. 


change- 
nick 


On 


With change-nick module enabled, your users can have 
the ability to change display nickname after logged in. It 
makes your chat more flexible and has more fun. 
"enable": Enable the change nickname function. 
"enableCustomProfile": Users can have their own 
profile panel other than a nickname, in the panel they 
can change their display nickname, location, sex, age 
and avatar after logging in when the value of 
enableCustomProfile is on. Otherwise users can 
change nickname only. 


invisible- 
admin 


On 


With the invisible-admin module enabled, the 
administrator can monitor the chat conversations in 
chat rooms invisibly. 

Without the "existence" of the administrator, chatters 
can freely talk but 

can also be stopped by the administrator if their 
language is inappropriate.. 


encrypt- 
message 


off 


With encrypt-message module enabled, messages will 
be encrypted to ensure the security of the chat server. 
123flashchat encrypts messages using RSA. 


event-chat 


On 


Certain chat room(s) can be configured to automatically 
open and close at a particular time. 

You may broadcast some chat topic on the website 
before the event, and edit the chat history to be quality 
web content after the event. 

Event-chat is an effective way to gather more traffic to 
chat room. 


image- 
transfer 


enableLobbyz"On" 
enablePrivate=“On 


uploadURL-^ dow 


With the optional Image Transfer Module enabled, users 
are able to share pictures with each other to add spice and 
power to the conversation. Only JPG or JPEG formats are 
allowed. 
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nloadURL=“* maxU 
PLoadSize=“512” 
imageHeight="300” 
imageWidth=“400” 
allowGuest-"Off" 
autoLoadlmage-"O 
ff” 
flashcom- audio=“Off” With flashcom-audio-video module enabled, and 
audio-video | video=“Off” macromedia flash media server installed, your chat can 
needRequest-"On" | have webcam and voice chat features. 
adminNeedReques | Unlike the basic text chat, this module needs support of 
t=“Off” flash media server. 
canShutOffAdmin= 
“On” 
moderatorNeedRe 
quest-"Off" 
canShutOffModerat 
or=“On” 
maxWindow="5” 
activeRooms=“*” 
allowGuest-"Off" 
white-board | enable=“Off” With which users can draw on whiteboard while others 
userDrawPermissio | can watch or join him to draw more. 
n=“11110” 
userModifyPermiss 
ion=“11110” 
width=“510” 
height-"400" 
buddy-list On Besides the userlist tab, you will find a buddylist tab. 
Where the registered users are entitled to add registered 
users to the buddylist and get buddies’ status: 
online/offline, and can remove buddies and private chat 
with buddies. 


4.1.2.8 Logo Configuration 


Sample: 


<logo href=“www.123flashchat.com“ src=””’></logo> 


Parameter 


Type 


Description 


href 


String 


Define your homepage link, then a 
click on the logo will link the visitors 
to your homepage in a new 
browser window. 

It can be left blank to disable any 
link. 


src 


String 


It defines the origin of the logo file. 
To leave it blank means the logo 
file is located in the default skin 
folder, 

you may also fill in an URL which 
starts with "http://" here to define 
an external logo picture. Default 
value: "" 
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4.1.2.9 «room id».xml 


In the directory: 
<123flashchat installed directory>/server/data/default/rooms/ 
There are files named “<number>.xml’. 
For example: 1.xml, 1032.xml 
Each one of these files represents a chat room. 
The room change in admin panel will affects these xml files accordingly at real-time, ie: 
when adding a room in the admin panel, one file will be generated into this directory; 
when deleting one room, one file will be removed from this directory. 
For example: 
<?xml version=“1.0” encoding-"UTF-8"?» 
<room> 
<name>Main Test</name> 
<max>200</max> 
<des>Tip: test register, enter, exit room, send, newline, etc</des> 
<owner>admin</owner> 
<speaker></speaker> 
<password></password> 
<member-only>Off</member-only> 
<pass-all-message>Off</pass-all-message> 
<roomOpen> 
«Time o-"special" s2"2006-04-18 17:55:00” ez*2006-04-18 18:01:00”></Time> 
</roomOpen> 
</room> 


Note: file name is room ID, not room name. 


Parameter Type Description 
name String Chat room name 
max Number Max number of people in one 


room, which is limited by the user 
license you have. 


des String Chat room description and 
introduction. 
owner String Chat room owner= moderator who 
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can kick any one causing a 
nuisance. 

To have two or more moderators, 
please enter the owner list in this 
tag separated by “,” with no spaces 
between. 

eg: aaa,bbb,ccc. 

In admin panel, moderatators can 
be added, editted and deleted. 


speaker 


String 


When a room’s status is set to 
‘moderated-chat’, all the messages 
from ordinary users are not made 
public unless the moderator 
passes them. 

Another type of user is “speaker”. 
A speaker is entitled to talk freely 
in public without the consent of the 


moderator. 


To have more than one speaker, 
the list of speakers can be entered 
into the tag, separated by “,” with 
no spaces between. 

eg: aaa,bbb,ccc. 


A speaker can not kick someone 


from the chat room. 


Leave the field of speaker to be 
blank if you want. 


password 


String 


Chat Room password. 

If you do not want a password to 
protect a chat room, leave this 
section blank. 


member-only 


On/Off 


This determines whether a room is 
'members only' or open to all 
including guests. 


pass-all- 
message 


On/Off 


Enable or disable moderator chat 
mode(need moderator chat 
module) 


room-open 


room-open - Define the particular time to open 
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>time and close the chat room. 
room-open - Normal/Special Room mode, "normal" means 
>time- o certain time period of each day or 
certain day of a week. 
"special" means special chat event 
of a particular day. 
room-open - number Example: 2006-04-18 17:55:00 
»time- s Room start time. 
room-open - number Example: 2006-04-18 18:01:00 
>time-e Room end time. 


When you're done with room editing in xml files, save them as ANSI/ASCII format, 
otherwise the chat server can’t recognize them. 


4.2 Client Configuration 


There are three client configuration files: 

1. client.xml, 

2. skin.xml, 

3. color.xml 

The modifications for these files will not be effective until the chat client is re-opened. 


4.2.1 client.xml 


Only values can be changed, not the names. 


Parameter Type Default value Description 
HomeUrl String http://www.123f | This is the URL you want the logo to 
lashchat.com link to. If this is set to 'null', there will 
be no link over the logo. 

HelpUrl String help/index.html | This is the URL for the help file. This 
can be translated to any language 
locally, uploaded to your web server 
and the new help URL can be 
inserted here. 

registerUrl String null This parameter will not need to be 
configured if you are using 123 Flash 
Chat to store your user data. 

This parameter is only required if you 
are using an external database. 
copyright string Copyright This is your company copyright 
2001-2005 information. This will be displayed in 
TopCMM the “about” panel. 
Computing Inc. 
All Rights 
Reserved. 

loadRootPath string null This is the directory where the 
language folder and skin folder are 
located. These should be left as ‘null’. 
If however you put them on another 
server, please set them to http://url/ 
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For example: 
“http://www. 123flashchat.com/chat/” 
Don't forget the slash at the end. 


language string li Choose the interface language from 
our collection. Current versions of 
123 Flash Chat offer the following 
choices: 
1) en - English (default) 
2) zh-CN - Simplified Chinese 
3) zh-TW - Traditional Chinese 
4) nl - Dutch 
5) fr - French 
6) ja - Japanese 
7) es - Spanish 
8) de - German 
9) it - Italian 
10)hu - Hungarian 
11)ru - Russian 
12)hr - Croatian 
13)tr - Turkey 
14)ar - Arabic 
15)pt - Portugues 
16)ko - Korean 
17)serbian - Serbian 
18)pl - Polish 
19)no - Norwegian 
20)farsi - Farsi 
21)el - Greek 
22)iceland - Iceland 
23)cs - Czech 
24)da - Danish 
25)fi - Finnish 
26)sv - Swedish 
27)pt-br - Brazil Portugues 
Note: the language files are located 
in the folder: <loadRootPath>/lang/ 
The interface can also be translated 
into other languages which are not 
included in this list. If this is the case, 
please save it as language_***.xml. 
Put it into the same folder and edit 
language setting in "client.xml". You 
will then get a local version of 123 
Flash Chat. 

skin string standard We offer the following skins: 


1) standard - Aqua blue skin, scalable 
vector skin. 

2) beige - Aqua beige skin, scalable 
vector skin. 

3) angel - Black metallic bitmap skin. 
4) hawaii - Aqua black skin, scalable 
vector skin. 

5) classic - Blue bitmap skin. 

6) green - Green skin, scalable vector 
skin. 

7) red - Red& black skin, scalable 
vector skin. 

8) orange - Orange skin, scalable 
vector skin. 
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9) clean - Aqua blue & gray skin, 
scalable vector skin. 

You can also design a new skin 
based on the existing skins. 
profileUrl string null You can either enable or disable the 
"profile" option by setting the value to 
"true" or "false". 

If itis enabled, enter the correct value 
after the "urlz",eg: 
http://yourwebsite/profile.php ?user= 
AUSER% 

the “profile” link can be found when 
activating a user from the user list in 
the pop up menu. 

Click on the “profile” link to view the 
user's details in a new browser 
window. 

The URL value can be the profile link 
in your existing database or even the 
profile link of another website. 

Note: you can add multiple profile 
URLs. 

enableRoomSounds boolean true This is the default sound setting in 
the chat room. This can be enabled 
by selecting “true” or disabled by 
selecting “false”. 
enableMonitorSounds | boolean true This is the default sound setting in 
the monitor panel for the 
administrator. It can be disabled by 
selecting “false”, however we strongly 
recommend it to be set to “true” in 
order to monitor a chat room with 
sound alerts. 

enterRoomSound boolean true This is where you can choose 
whether or not to play a sound alert 
when anyone enters the room you 
are in. 

The default value for this is “true” 
which is also the default value for all 
your members. 

Your members can set their 
preferences in their option panel. 
messageSound boolean true This is where you can choose 
whether or not to play a sound alert 
when receiving a message. 

The default value for this is “true” 
which is also the default value for all 
your members. 

Your members can set their 
preferences in their option panel. 
typingSound boolean true This is where you can choose 
whether or not to play sound when 
typing messages. 

The default value for this is “false” 
which is also the default value for all 
your members. 

Your members can set their 


preferences in their option panel. 
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This is where you can choose 
whether or not to play a sound alert 
when sending a message. 

The default value for this is "true" 
which is also the default value for all 
your members. 

Your members can set their 
preferences in their option panel. 


quitRoomSound 


boolean 


true 


This is where you can choose 
whether or not to play a sound alert 
when someone exits a room. 

The default value for this is “true 
which is also the default value for all 
your members. 

Your members can set their 
preferences in their option panel. 


singleLineMode 


boolean 


false 


This enables switching to a single- 
line or multi-line mode. 

Messages can be set next to the 
speaker by choosing “true”. This will 
save chat space. For example: 

“Mr.A says: Hello.” 

Messages can be displayed on a new 
line by choosing “false”. For example: 
"Mr.A says: 

Hello." 

"false" will then be the default value 
for all your members. 

Your members can set their 
preferences in their option panel. 


parseURI 


boolean 


true 


This is where you can make the URL 
address in messages clickable or not. 
If the value is set to “true”, then the 
valid URL, (a string with "http://" or 
"www.*****" which is 9 characters at 
least) will become underlined and 
linked to the specified URL. 

Defaul value is “true”, which is also 
default value for all your members. 
Your members can set their 
preferences in their option panel. 


autoSaveUsername 


boolean 


true 


When the value for this is set to “true” 
a chatter's username will 
automatically be saved in the cache. 
The default value for this is "true" for 
all of your members. 

Your members can set their 
preferences in their option panel. 


autoSavePassword 


boolean 


false 


When the value for this is set to "true" 
a member's username will 
automatically be saved in the cache. 
The default value for this is "false" for 
all your members. 

Your members can set their 
preferences in their option panel. 
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When the value for this is set to "true" 
a chatter's avatar, font style and color 
will automatically be saved in the 
cache. 

The default value for this is "true" for 
all your members. 

Your members can set their 
preferences in their option panel. 


autoSaveBKGround 


boolean 


true 


When the value for this is set to "true" 
a user's chat space background will 
automatically be saved in the cache. 
The default value for this is "true" for 
all your members. 


visibleGuestCheckbox 


boolean 


true 


If this is set to “true”, the combination 
of “guest” and the checkbox before 
“guest” will be visible to all users. 


visiblePasswordlnput 


boolean 


true 


If this is set to "true" , the password 
input field will be visible to all users. 


visibleLogoutButton 


boolean 


true 


If this is set to "true", the logout 
button will be visible to all users. 


defaultSelectGuest 


boolean 


false 


This can be set to be "true" if the 
guest is checked as default. 


enablePrivateChat 


boolean 


true 


This enables or disables the private 
chat mode for ordinary users. 
Remember: the administrator can 
always activate a 'private chat' with 
ordinary. 


acceptPrivateMessage 


boolean 


true 


The user can accept all private 
message invitations or deny them by 
default with this setting. 


lockAdminlcon 


boolean 


true 


This is set to "true" if the 
administrator has a unique reserved 
icon (a small person with coffee) 
before their messages. 

It is not referring to the icon before 
the administrator in the user list. 


messageSpacing 


Number 


You can set the spacing between two 
messages here. 


messageHistorySize 


Number 


To allocate space to record chat 
history. Please set the default space 
size here for all your members. unit: 
kb 


showGuestMemberonl 
yRoom 


boolean 


To define if the member-only room is 
viewable to guests in a room list. 


visibleWelcomeMessa 
ge 


boolean 


To define whether or not to display 
the admin auto-welcome message 
when anyone enters the chat room. 


visibleExitMessage 


boolean 


To define whether or not to display 
the admin auto message when 
anyone leaves the chatroom. 


visibleRoomList 


boolean 


true 


To display room list or hide it. 


advertisingBanner 


boolean 


false 


To insert one or more advertisement 
banners onto the chat client. 
Set enable to "true" to activate this. 


banner-»src 


string 


This is where you can make the URL 
of an advertisement banner source a 
JPG or swf. The URL could be a 
relative path or an absolute. 
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The URL linked with the 
advertisement banner. 


banner-> duration 


Number 


Advertisement duration time. 


visibleChangeRoomCo 
mboBox 


boolean 


true 


This indicates whether the pull-down 
room menu for users to switch rooms 
in a chat window is visible or not. 


visibleExitRoomButton 


boolean 


true 


Add or remove an exit room button at 
the top right. 


adminAutoGreet 


boolean 


false 


The ‘robot’ greetings administrator 
automatically gives to visitors can be 
displayed one by one. 

You can add as many lines as you 
want to make it look like a real 
person. 

This feature can be disabled by 
setting it to “false”. 


visibleHelpButton 


boolean 


true 


Add or remove the ‘Help button’ from 
the top menu. 


visibleOptionButton 


boolean 


true 


Add or remove the ‘Option button’ 
from the top menu. 


visibleAvatarButton 


boolean 


true 


Add or remove the ‘Smiley button’ 
from the middle menu above the 
input area. 


visibleBButton 


boolean 


true 


Add or remove the ‘B button’ from the 
middle menu above the input area to 
enable or disable the bold font 
feature. 


visiblelButton 


boolean 


true 


Add or remove the ‘I button’ from the 
middle menu above the input area to 
enable or disable the italic font 
feature. 


visibleUButton 


boolean 


true 


Add or remove the 'U button' from the 
middle menu above the input area to 
enable or disable the underline font 
feature. 


visibleColorButton 


boolean 


true 


Add or remove the 'Color picker 
button' from the middle menu above 
the input area to enable or disable 
the font color feature. 


visibleSelectSmileyBut 
ton 


boolean 


true 


Add or remove the 'smiley button' 
from the middle menu above the 
input area to enable or disable the 
emotion feature. 


visibleSelectBgButton 


boolean 


true 


Add or remove the ‘BG button’ from 
the middle menu above the input 
area to enable or disable the change 
chat background feature. 


idleDisconnectTime 


number 


When a user is "idle" in chat room for 
a predefined time, 

his connection will be automatically 
cut and he will be kicked out of the 
room. 

This time period can be defined here 
by admin, "0" means to disable this 
feature, and the users won't be 
kicked no matter how long he stays 
without saying or doing anything. 
Measurement units: minute. 
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Display the timestamp in all users' 
chat windows. Users can enable or 
disable this feature by themselves in 
the option panel. 


predefineMessage 


boolean 


true 


Frequently used messages can be 
easily added to/removed from the 
predefined section to save time, 

they can be easily copied into chat by 
double-click. 

Content can be defined in "msg 
value". 


openPrivateMsgInWin 
dow 


boolean 


false 


Whether or not to open each private 
message in a new browser window 
and the size of it. 

Admin can preset this option for all 
users. 


flashEmotion 


boolean 


true 


Animated emotions can be chosen 
and appeared to the chat lobby or 
private chat. 

The recipient in private chat, or all 
users in lobby, can click “play” to 
enjoy the specific flash. 

by default it's “true”, means the 
emotion button will be visible to all 
users. 


Item: 

- name: Emotion name 

- src: flash file location 

- thumb: thumbnail location 

- duration: animation duration 
(seconds). 


showSmileLimit->value 


number 


Restrict the max number of smileys in 
each message. 
valuez"0" means no restrict 


4.2.2 Skin configuration 


123 Flash Chat is skinable. The skins are stored in the folder: <123FlashChatServer 


installed directory>/server/etc/groups/default/skin 


To assign a default skin from the available skin collection to all the users in a chat room, 


123 Flash Chat administration has two choices: 


1. configuring client.xml, or 


2. editing html code 


Check details 


4.2.3 Predefined Message 


Frequently used messages can be easily added to/removed from the predefined 
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section to save time, they can be easily copied into chat input area by double-click. 
After editing it or just confirming it, press "send" to publish it. 


In client.xml, find: «predefineMessage» section: 


enable boolean true Enable predefined message function or not. The 
canned messages Admin defined in client.xml will 
be available to all users by default 
msg value string Default canned message content. 


The regular users can define their own messages in chat panel, above chat input area 
there is a middle toolbar and the last icon is for define and launch canned message. 
predefineMessage panel 

- add: press “+” to activate add message window. 


- Delete: choose one message then press “-” to remove it. 
- manage pages: Multiple canned messages can be managed in multiple pages. 


4.2.4 Change Private Message Location 


Private message has two optional locations: in current SWF or in new browser window. 
If in current SWF, the loading speed of new private window is much faster; But if in new 


browser window, it may be easier to manage multiple PMs. 


enable boolean false Whether or not to open each private message ina 
new browser window and the size of it. Default 
setting defined by admin. 
width number 475 Default width of new browser window, in pixel. 
height number 240 Default height of new browser window, in pixel. 


Note: Too many concurrent PMs in new browser windows may lag speed of your 
computer. 

Admin can predefine this option in client.xml to be default setting for all users, and 
regular users can change setting by themselves in option panel according to their 
computer performance. 


4.2.5 flashEmotion configuration 


Animated emotions can be chosen to launch a "play" button into the chat lobby or 
private chat. Other users can click "play" to enjoy the flash. 


Change FlashEmotion 
Nine default flashEmotions are packed into the free demo of 123flashchat. You can 
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also add/remove/change current collection. FlashEmotions are stored in one folder 
named "flashemotion" by default externally from the SWF, and controlled by xml file: 


client.xml. 
To add new FlashEmotion(s), firstly put new flash animations to the FlashEmotion 
folder, then edit client.xml, find flashEmotion section, add new line(s) to define the 
location and duration. 


enable boolean flashEmotion button will be visible/invisible to all 
users by default. 

col number 3 Default column of flashEmotions. 

row number 3 Default row of flashEmotions. 

autoPlay boolean false Whether or not the flashEmotion will be auto play 
in current window. 

name string flashEmotion name 

src string The original flash file location. The recommended 
dimension of flashEmotion: 500x400 px. Better not 
bigger than 630x470 to look good. 

thumb string thumbnail location. 
The recommended dimension of thumbnail: 46x46 
px. Other size is okay too, but too big in size will 
lag the loading speed of the SWF. 

duration number 18 animation duration (seconds) of each 
flashEmotion, it's depending on the SWF itself. 


4.2.6 sendSound configuration 


Ten default flashSound are packed into the free demo of 123flashchat. You can also 
add/remove/change current collection. 
"flashSound", and controlled by xml file: client.xml. 

To add new flashsound(s), firstly put new mp3 file to the flashSound folder, then edit 
client.xml, find flashSound section, add new line(s) to define the location. 


FlashSounds are stored in one folder named 


enable boolean flashSound button will be visible/invisible to all 
users by default. 
autoPlay boolean false Whether or not the flashSound will be auto play in 
current window. 
name string flashSound name 
src string The original mp3 file location. 
4.3 Client Admin Panel 


Log in the flash client as administrator and click the “admin” button at the top of the 
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menu to enter admin panel. The top buttons have the following functions respectively: 


4.3.1 Monitor 


In the “monitor” panel, the administrator can monitor every action of all logged in users. 
For example: connect to server, login, enter room, exit room, change room, logout chat 
server, etc. 

Other information shown here includes: logged in user IP, country and time stamp. 
Note: Once a user logs in with a username and password they have a unique user-id, 
that's the username he used to log in. Despite any nickname they may choose to 
change to afterwards, their user-id will remain the same and will be displayed in the 
monitor window until they log out. 


4.3.2 SETTINGS 


In the "settings" panel, you can change the following variables: 


Parameter Type Description 

Enable user registration CheckBox Check to enable user registration 

Enable guest login CheckBox Check to enable guest login 

Save public chat history CheckBox Check it to save the message history 
on the chat server 

Save private chat history | CheckBox Check it to save the message history 
on the chat server, by default it's not 
checked. 

Timezone Number Define timezone for the chat room. 


Also in this tray, you can change logo and filter words. 


4.3.3 Rooms 


In the "room" panel, you can add, delete or edit rooms, controlled by the right botoom 
buttons. 

You will be notified of the result of the action of “add”, “delete” or "edit". 

Rooms you add will appear in real-time in the list of rooms. 


In the room details section, an asterisk (*) indicates a required field. 

Room name: name of current room. 

moderator: he can kick a nuisance person from using the current chat room and set 
a room to 'Moderated-chat'. In such a room, all messages from ordinary users will be 
disabled from being displayed publicly unless the moderator or admin passed them. 


(“Moderated-chat” is a plug-in module which is not included in the standard full 
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version by default.) 

Max users: This value is limited to the license you have purchased. 

Password: Leave this blank if you want this to be a public room. 

Speaker: Is another user type used in ‘Moderated-chat’. The speaker can freely chat 
and their words will be displayed publicly without the consent of the moderator or 
admin. Leave this as 'null' if you do not need a speaker. 

Description: Chat room introduction to attract visitors. 

Member only: This defines whether guests can access a particular room. 

Turn on moderate-chat mode: Set the default value if this room is a moderated-chat 
room. 

Set room public time: Set the public time of the specific room. Click *add" to add a 
rule first and click "submit" to save changes. 

The room mode: 

- “normal”: means certain time period of each day or certain day of a week. 

- "special": means special chat event of a particular day. 

- "EveryHour": means recurring period of each hour. 


4.3.4 Ban 


In the “Ban Panel” admin can ban users or ban IP. 

@ Ban or unban a username. 
Note: This applies to the user’s original username, not their currently displayed 
nickname. If you ban someone but it fails, please find out their real username in the 
monitor window and try again. 

e  Banorunban an IP address or IP range, 


4.3.5 Announcement 


In the "Announce Panel" you can broadcast messages to every logged in user, whether 
in specific chat rooms or just in the room list page. 


4.3.6 Admin Account 


Here you can manage the multiple admin accounts. 


You can also update the administrator password here. Due to security reasons it is very 
important to change the default admin password after you have set up the chat server 
for the first time. 

The new password will be stored in default.xml as MD5 encrypted. 


Tip: If you forget the admin password, you can manually edit admin tag in "default.xml", 
do not forget to change the admin tag md5=“off”. 
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For example: «user name=“admin” passwd-"mypassword" md5=“Off” /> 

Now you can log into chat with the new password: “mypassword”. 

Then admin panel-> password panel, edit password again. 

In this way your final password will be stored in fcserver.xml as a MD5 encrypted string. 


4.3.7 Chat bot Message 


This feature can be used for site news or text advertisements. 

With "Chat Bot”, specific message(s) can be broadcast to specific rooms or all rooms at 
predefined intervals. 

Messages can be added, edited and removed from the list. 

There can be multiple messages for one room, or one message for all rooms. 


4.4 Integrate database configuration 


123 Flash Chat supports integrating the existing database of your forum or portal system 
such as phpBB, PHPNuke, PostNuke, AspNuke, etc., or of other user systems. 

Basically 123 Flash Chat can integrate database of any kind, as long as there's username 
and password in it, but if your website do not support a database your user information will 
not be able to be integrated. If this is the case you can use 123 Flash Chat to store your 
user information. 


There are a few steps to integrate a database: 

1) configure default.xml. 

The modes of IntegratedOtherDatabase in default.xml include: 
None — does not use an integrated database to authorize users 
Mysql - uses a mysql database 

Oracle - uses an oracle database 

Common - uses all kinds of databases, advanced setting. 

URL - uses a web URL to authorize a user's login information. 
ODBC - uses an ODBC to connect to any database you want. 
2) Configure the database xml file. 


It could be: 


a) Mysgl.xml 


Parameter | Type | Description 


| database-host 


string The hostname of the 
database server. 
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database-name string The database name you 
are using. 


database-user string The user name which is 
required to connect to the 
database. 


database-password string The password which is 
required to connect to the 
database. 


user-table string The table to store the user 
information. 


username-field string The column of names of the 
user names in the user- 
table. 


password-field string The column of names of 
passwords in the user- 
table. 


enable-md5 string It defines whether the 
password is encrypted with 
MD5. 


On - encoded. 
Off - not encoded. 


Passwords in many portal 
systems and forum systems 
like php-nuke, post-nuke or 
phpBB, etc. are encrypted 
with MD5, thus you will 
need to set this value to 


‘On’. 
b) Oracle.xml 
Parameter Type Description 
mode string It could be “thin” or “oci” only. 


It indicates the way to 
access the database. The 
default value is "thin". If you 
choose "oci", then your 
server must have installed an 


oracle client. 
database-host string The hostname of the 
database server. 
database-port number The port of the database. 
database-sid string The sid of the database 
server. 
service-name string The service name to connect 


to oracle. It doesn't take 
effect unless you choose the 


mode "oci". 
database-user string The user name which is 

required to connect to the 

database. 
database-password string The password which is 


required to connect to the 
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database. 


user-table string The table to store the user 
information. 


username-field string The column name of user 
names in the user-table. 


password-field string The column name of 
passwords in the user-table. 


enable-md5 string It defines whether the 
password is encrypted with 
MD5. 


On - encoded. 
Off - not encoded . 


Passwords in many portal 
systems and forum systems 
such as php-nuke, post-nuke 
or phpBB, etc. are encrypted 
with MD5, thus you will need 
to set this value to "On". 


C) CommonDB.xml 


Parameter Type Description 
jdbc-driver string The name of the jdbc driver. 
jdbc-url string The complete jdbc URL. If 


the user name and 
password are required 
when the database is 
accessed, they must also 
be included. 


user-table string The table to store the user 
information. 


username-field string The column name of the 
user names in the user- 
table. 


password-field string The column name of 
passwords in the user- 
table. 


enable-md5 string It defines whether the 
password is encrypted with 
MD5. 


On - encoded. 
Off - not encoded . 


Passwords in many portal 
systems and forum systems 
such as php-nuke, post- 
nuke or phpBB, etc. are 
encrypted with MD5, thus 
you will need to set this 
value to "On". 
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d) Using URL to authorize a user's login information. 


You can authorize a users' log in information by using a dynamic web application. 
You can activate this integration method by following the tag below: 


Once set to "URL", another 2 arguments have to be defined to avoid error. 

For example: 

http://www.yourhost.com/login chat.php?username-9?eusername9?6&amp;password-?opa 
ssword% 

Or: 
http://www.yourhost.com/login_chat.asp?username=“%username%&amp;password=%pa 
ssword% 

One argument is the %username%, the other is the %password%. 

“&amp;” is the character "&' in xml. 

That is to say when the user enters their username: *myname" and their password: 
“mypassword” , the chat server will visit: 

"http://www.yourhost.com/login chat.php?username-myname&password-mypassword" 
to get the login information which will return a number between 0 to 7, each with a 
different meaning. See the table below: 


Value Description 

0 successfully login as ordinary user; 

1 wrong password ; 

2 the username can't be used ; 

3 login error, e.g. error in connecting database ; 

4 username does not exist; 

5 successfully login as the administrator; 

6 guest login not allowed 

ODBC.xml 

Parameter Type Description 

dsn-name string The DSN name of your 
ODBC 

database-user string Enter username if it is 
required by your ODBC. 

database-password string Enter password if it is 
required by your ODBC. 

user-table string The table to store the user 
information. 

username-field string The column name of user 
names in the user-table. 

password-field string The column name of 
passwords in the user- 
table. 

enable-md5 string It defines whether the 
password is encrypted with 
MD5. 
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On - encrypted. 
Off - not encrypted. 


Passwords in many portal 
systems and forum systems 
such as php-nuke, post- 
nuke or phpBB, etc. are 
encrypted with MD5, thus 
you will need to set this 
value to "On". 


5. Chat Modules 


The 123 Flash Chat Server releases several powerful chat modules. They can greatly 
enhance the chat but are not obligatory for every webmaster. Therefore they are not included 
in the standard package. 

Users can choose these optional modules according to their needs. 

All modules are just plug-ins based on 123 Flash Chat Server Software which works with the 
license instead of working alone. 


5.1 Moderated chat module 


The distinguishing feature of a "Moderated-Chat" ( moderation chat or moderate chat) is that 
questions submitted by participants will not be displayed publicly unless the Moderator or 
Admin approved/passed it. 

Check details here: 


http://www. 123flashchat.com/moderated-chat.htm| 


5.2 Invisible admin chat module 


With this module the administrator can monitor chat conversations in chat rooms invisibly. 
Without the “existence” of the admin participants can freely chat but the administrator can 
make sure that no one is being inappropriate in the chat room. 

Check details here: 


http:/Awww.123flashchat.com/invisible-admin.html 
5.3 Change nickname module 
With the “Change-Nickname Module’ installed, your users have the ability to change their 
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displayed nickname,location,sex,age after they have logged in. This makes their chatting 
more flexible and fun. 


Parameter Type Default | Description 

| value 
enable On/Off On Enable the change nickname function 
enableCustomProfile On/Off On Users have the ability to change their 


displayed nickname, location, sex, age after 
they have logged in when the value of 
enableCustomProfile is on. Otherwise users 
can change their nickname only. 


Check details: 
http://www.123flashchat.com/change-nickname.html 


5.4 Pocket-pc & banner chat module 


Have you ever thought of attaching a ‘mini-chatroom’ to your webpage to establish 
connections between your business and visitors? "Pocket PC or Banner Chat" could be the 
solution. 

It is small and neat and looks like an animation but has full chat features (sending and 
receiving message in chat lobby, etc.) 

It can be attached to any webpage of your site. 

A tiny little chat room will encourage visitors to communicate with your representative. This 
will help them to gain a better understanding of your product or service which will definitely 
promote sales. 

Check details: 


http://www.123flashchat.com/pocket-pc-banner-chat.html 


5.5 Audio-Video module 


With audio-video module enabled, you can add webcam and voice chat. 

In video-voice chat, 8k/sec bandwidth is used by default. And this bandwidth consumption is 
adjustable. 

Unlike the basic text chat, this webcam chat module need user have a server enable the rtmp 
protocol, such as Flash Media Server, Flash Communication Server, Red5 or 
WowzaMediaServer. 

If you haven't obtained the flash media server or flash communication server yet, you can buy 
directly from macromedia: http://www.macromedia.com: Flash Media Server. Or you can use 
the Red5 server (a free Open Source Server) and you can try the WowzaMediaServer, too. 
We recommend Flash Media Server to get the best performance. 


Video Control 
The code to activate video function to 123flashchat, sample: 


< audio-video audio=“On’” video=“On” needRequest-"On" adminNeedRequest-"Off" 
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canShutOffAdminz"On" moderatorNeedRequest-"Off" canShutOffModerator-"On" 
maxWindow=“5” activeRooms-"*" allowGuest=“On’></audio-video> 


Parameter Type Default | Description 
value 
activeRooms number 1 The room list in which the video function is 


aD 


enabled. by default it's “*”, means video is 
ON in all rooms. eg: to enable video in room 
with ID: 1, 2 and 3, please set “1,2,3”, and 


delimit room IDs using comma’”,”. 


allowGuest On/Off On Whether or not to allow unregistered guest 
to publish or view video. 

audio On/Off On Enable the audio mode 

video On/Off On Enable the video mode 

needRequest On/Off On When someone is requested video/audio by 
others, he/she is able to accept or deny the 
invitation. 

adminNeedRequest On/Off Off This function decides whether the admin 
user need send request with others 
video/audio 

canShutOffAdmin On/Off On This function decides whether the others 
could cancel the video/aduio to the admin 
users 

moderatorNeedRequest | On/Off Off This function decides whether the 


moderator user need send request with 
others video/audio 


canShutOffModerator On/Off On This function decides whether the others 
could cancel the video/aduio to the 
moderator users 


http://www.123flashchat.com/video-chat.html 


5.6 Encrypt-message chat module 


With this optional chat module, chat messages can be encrypted by using RSA, which ensure 
the privacy and chat security. 


http://www.123flashchat.com/encrypt-message.html 


5.7 Event-chat module 


With this optional chat module, chat room can be opened and closed at a particular time to 
gather more traffic. 

The entrance: Admin Panel-> Room Panel-> Set room public time-> Set. 

Set the public time of the specific room. Click “add” to add a rule first and click "submit" to 
save changes. 

The room mode: 

- “normal”: means certain time period of each day or certain day of a week. 

- “special”: means special chat event of a particular day. 

- “EveryHour”: means recurring period of each hour. 


http://www. 123flashchat.com/event-chat.htm! 
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5.8 Image-transfer module 


With this optional chat module, user can send an image in the chat lobby window or in 
the private chat window. 
The code to activate upload-image function to 123flashchat, sample: 


«image-transfer enableLobbyz" On" enablePrivate=“On” 
uploadURL=““ downloadURL-'** maxUPLoadSize-z" 50" imageHeight-" 200" 


imageWidthz"200" allowGuest=“On’’></image-transfer> 


Parameter Type Default | Description 
value 
enableLobby String On Enable or disable transfer image (support 
file type: .jpg, .jpeg) in lobby chat window 
enablePrivate String On Enable or disable transfer image (support 
file type: .jpg, . jpeg) in private chat window 
uploadURL String Setting the URL that the file will be 


uploaded, you can use your own upload 
server (apache, tomcat, etc...) or use 
123flashchat http server, if you user 
123flashchat server, 

you must leave the uploadURL's value 
empty 


downloadURL String Setting the URL that the file will be 
downloaded, you can use your own upload 
server (apache, tomcat, etc...) or use 
123flashchat http server, if you user 
123flashchat server, you must leave the 
downloadURL's value empty 


maxUPLoadSize Number 1024 Setting the max file can be uploaded to the 
server, the value must less than the value 
maxUPLoadSize in «123flashchat installed 
directory»/server/etc/fcserver.xml, if the 
value less than or equals to 0, this means 
the server will not accept any upload files. 


imageHeight Number 200 The height of uploaded image that will be 
displayed in the lobby or private chat 
window 

imageWidth Number 200 The width of uploaded image that will be 
displayed in the lobby or private chat 
window 

allowGuest String On Setting if the guest can upload file 

autoLoadlmage String Off Enable or disable auto load an image and 


display it in the window, if disable this 
function, the user will get an alert message 
instead of load the image from server 
directly. 


5.9 White-board Module 


TopCMM Software 
http://www.123flashchat.com 


123 Flash Chat User Manual 
2007-10-26 
Pages: 54 of 81 


With this optional chat module, users can use whiteboard function during chat to make 


drawing and all other users in the same room can see the drawings or join him to draw 


more. 


The whiteboard has the basic functions as other painting tool, it will be opened in a 
standalone window floating over the chat screen but still in the same SWF. 

Admin has the right to enable/disable the drawing and erasing function. 

Before purchasing and installing this whiteboard, please purchase Flash Media Server 
from Macromedia first. Or at least install red5 which may not be very stable when many 
users use whiteboard at the same time. 


The sample code to activate white-board function in 123flashchat: 
«white-board enable=“On” 
userModifyPermissionz"11110" widthz*510" height="400"></white-board> 


userDrawPermissionz"11110" 


Parameter 


Type 


Default value 


Description 


enable 


String 


Off 


Enable or disable white board function 


userDrawPermission 


Number 


11110 


It defines who are entitled to use the 
drawing function. 


The value has 5 digits by default, the 
sequence of the bits from the left to the 
right represents the admin, moderator, 
speaker, regular user(registered user) and 
guests' drawing permission in turn. 


“1” means ON and "0" means OFF. For 
example: if you only want admin, 
moderator , speaker have the drawing 
permission, then the value will be set to 
“11100” 


userModifyPermission 


Number 


11110 


It defines who can use the eraser. The 
value has 5 bits in default, the sequence of 
the bits from the left to the right represent 
admin, moderator, speaker, regular 
user(registered user) and guests' 
permission to erase in turn. 


“1” means ON and "0" means OFF. For 
example: if you only want admin, 
moderator , speaker have the right to 
erase, then the value will be set to “11100” 


width 


Number 


510 


The width of the whiteboard window 


height 


Number 


400 


The height of the whiteboard window 


5.10  Flash-Media-Server Setting: 


When you have the flash com (AV) module or the white board module, you should set the 
value of “targetURI”. 


Sample: 
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«flash-media-server targetURI-"rtmp:/123flashchat"»«/flash-media-server- 


Parameter 


Type 


Default value 


Description 


targetURI 


String 


rtmp:/123flashchat 


The Uniform Resource Identifier (URI) of 
the application on the Flash 
Communication Server that should run 
when the connection is made. 


To specify targetURI, use one of the 
following formats (items in brackets are 
optional): 


rtmp:[port]/appNamef[/instanceName] 
(acceptable if the movie and the Flash 
Communication Server are on the same 
machine) 


rtmp-//host[:port/appName[/instanceName] 


For example, the following URIs are 
formatted correctly: 
rtmp://www.yourwebsite.com/123flashchat 
rtmp:/123flashchat default 


Notice: If you use the targetURI for white 
board module, you should make a new file 
named *main.asc" containing following 
code “load(“components.asc”);” and copy 
this file to the «Flash 
Media/Communication Server installed 
directory>/applications/Application 
Directory (appName)/ 


5.11 


Buddy-List Module 


With this optional chat module, users can use the buddylist function to add a buddy to the 
buddylist or delete a buddy from the buddylist, user can chat with the buddies whose are 


online at any time. 


The sample code to activate white-board function in 123flashchat: 
<buddy-list enable=“On’></buddy-list> 


Parameter 


Type 


Default value 


Description 


enable 


String 


Off 


Enable or disable the buddy list function 


5.1.2 Visual Avatar Chat Module 


With this optional chat module, text chat room can be transformed to avatar chat, in which users 


can walk around, "meet people" in the same room and gossip with them. The scenes are: cafe, 


game room, hotel, park, restaurant. 
«visual-avatar-chat enable-"On"» 
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«item name-"Café" src="graphicchat/room/café.swf’></item> 


«item name-"City" src=” graphicchat/room/city.swf"»«/item» 


«item name-"Gameroom" src=” graphicchat/room/gameroom.swf"»«/item- 


«item namez"Hotel" src=” graphicchat/room/hotel.swf’></item> 


<item namez"Park" src=” graphicchat/room/park.swf"»«/item- 


</visual-avatar-chat> 


Parameter Type Default value Description 

enable String Off Enable or disable the avatar chat function 
visual-avatar-chat- String Background name 

>item->name 

visual-avatar-chat- String Background flash file location 

>item->src 


6. How to customize chat skin 


Brief introduction: 


All sets of skins are stored under the directory: 
<123flashchat installed directory>/client/skin/. 


By default we offer 9 sets of skins. You can modify any skin or add 
your own based on the pre-existing skins. 


Skin components are controlled by skin.xml. 
Color style can be adjusted by color.xml. 


skin.xml and color.xml are located at <123flashchat installed 
directory>/server/etc/groups/default/skin/skinfolder/ 


Only SWF or JPG image file can be used to construct a skin. 
GIF or PNG files will not work. 


If you like the opaque background, you can save it as a jpg file (non progressive mode). If 
you would prefer a transparent background, please save it as a png or gif file and import 
it to flash to convert it to a swf file without the background. 


Client FLA files are not necessary to design a skin. 


Below are some tutorials which might be helpful for designers: 


a) HowTo customize skin? http://www. 123flashchat.com/howtoskin.htm! 


b) HowTo change skin color? http://www. 123flashchat.com/colormap.htm| 
c) HowTo customize background? 
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http://www. 123flashchat.com/howto change bkground.html 


Change background 

Every skin offers background pictures in the chat area. 

You can also create your own jpg or swf backgrounds and put them into the skin folder. 
New backgrounds should be in the dimensions within the basic background. The 
graphics for the new background will be added above the basic background. (We suggest 
you double click the background alternative in the download pack to get a better picture 
of how it should look like.) 

To offer more backgrounds for users to select, please edit skin.xml, 

Find the following section: 

«SKIN BKGROUND- 

«BKGROUND name=“Standard” valuez"bkground.swf" /> 

«/SKIN BKGROUND- 

Then add a new line in this format. "name" is for users to pick from. "value" is the 
filename of the background that you have created. 


7. Programmer's tools 


Server APIs are provided for 123 Flash Chat Server Software developers. This will enable 
the developers to obtain detailed chat server information. Client APIs are also provided 
to customize the chat client. 


7.1 Server API 


7.1.1 Get Server Running Status from the files 


When a chat server is running, some parameters are stored in text files which can be 
read by your application. Useful information can be extracted from them. 
This feature is included in the standard version of 123 Flash Chat. 


7.1.1.1 Get numbers 


To obtain a current connection number, the logon user number and the room number 
from a record file, use the following format: 
«123FC installed directory>/server/data/default/online.txt 


This file will real-time change according to the chat room status. 
Format: 
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< connection number >|<logon user number» |«room numbers» 

Sample: 230|180|10 

The example above shows that there are 230 connections on the chat server, 180 of 
them have logged in and there are 10 chat rooms altogether. 

This data can be read and displayed in php, asp or other dynamic webpages. 


7.1.1.2 Get username list of each room 


You can display the user name list of each room on your webpage by retrieving data from 
"room *.txt". 


In the «123 installed directory>/server/data/default/, you can find the following files: 
"room 1.txt ", "room 2.txt', etc. 
These files store the online user lists of relevant rooms. These will keep changing 


depending on the changes of specific rooms. 


7.1.2 Send command to server to operate or get real-time data 


This feature can be very handy for an advanced user. 
With it you can develop an application to connect to the chat server via a socket. Then a TCP 
string command can be sent to operate or obtain the real-time data. 


In “<123flashchat installed directory>/server/etc/groups/default/server.xml” file you will find: 
«server-api enable=“On”> 
<!-- auth-password 
Only commands made using the right key (password) will be authorized by the chat server 
and will be effective. 
B 
<auth-password>3874-3459-9293-2194</auth-password> 
<!-- allow-access-from-ip 
Only commands from this IP address are legitimate. 
If it is set to “ ", then commands from all IP address will be valid. This will not be secure. 
= 
<allow-access-from-ip>127.0.0.1</allow-access-from-ip> 
</server-api> 


The socket message string being sent is in standard syntax which will appear as shown 
below: 
<?xml versionz"1.0" encoding=“UTF-8”?><Command group=“default” 


api_pwd=“api_pwd_in_default.xml_file” typez*command type" “command_parameters.... “ /> 


Note: Remember to terminate XML-commands with a null-byte. 
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group: in the standard version, the group value has to be "default" 
api pwd: this has to be the "auth-password" value which is defined in “default.xml”. 
type: this is the type of the command being sent. It could be in the following types: 
"add room", *del room", “ broadcast" * private message “. 
command parameters: these are parameters needed for every command. They can be 
different for each command. These will be introduced later. 


Below is an example of a command string 
<?xml version="1.0” encoding-"UTF-8"?» «Command group=“default” api pwdz"3874-3459- 
9293-2194" type-"add room" name-"the room name" owner=“abcd” desc=“test” max="200” 


[> 
7.1.2.1 add_room 


Rooms can be added on the fly using the ‘add room’ command. 
The following parameters are indispensable: 


Parameter Type Description 

name String Expected room name 

owner String New room moderator 

desc String New room description 

max Number max number of people the new room can hold 
speaker String New room speaker 

member String Enable or disable guest to enter room 

pwd String New room password 

passallmess | True/fals | Enable or disable the moderator chat mode.(need 
age e moderator chat module) 


roomOpen Element | (Only supported when user have event chat module) 
roomOpen- | Element 


>Time 

Time->0 String Option: 
day1~day31 
special 

Time->e String End time 

Time->s String Start time 


A full sample of this command is shown below: 
<?xml version=“1.0” encodingz"UTF-8"?» «Command group=“default” api_pwd="3874-3459- 
9293-2194” type=“add_room” name="“test room” owner=“aaa’” desc=“room for test” 
max-"200" speaker=“bbb” member=“false” pwdz"" passallmessage-'true" > 
<roomOpen> 
«Time o=“day2” e="10:00:00” s="00:00:00"></Time> 
</roomOpen> 
</Command> 


For advanced details, please check webpage: 
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7.1.2.2 del_room 


Rooms can be deleted dynamically using this command. 
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Parameter Type Description 


room_id Number The ID of rooms needed to be removed. 


A full sample of this command can be seen below: 


<?xml version="1.0” encoding-"UTF-8"?» «Command group=“default” api_pwd="3874-3459- 


9293-2194” type-"del room" room_id="1” /> 


7.1.2.3 edit_room 


Rooms can be edited dynamically using this command. 


The following parameters are indispensable: 


Parameter Type Description 
roomid String The ID of rooms needed to be edited 
name String Expected room name 
owner String New room moderator 
desc String New room description 
max Number max number of people the new room can hold 
speaker String New room speaker 
member String Enable or disable guest to enter room 
pwd String New room password 
passallmess | True/fals | Enable or disable the moderator chat mode.(need 
age e moderator chat module) 
roomOpen Element | (Only supported when user have event chat module) 
roomOpen- | Element 
>Time 
Time->0 String Option: 
day1~day31 
special 
Time->e String End time 
Time->s String Start time 


7.1.2.4 broadcast 


This command will broadcast messages to every logon user, whether or not they have 


entered their username or entered a room. 
The following parameters are indispensable: 
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Parameter Type Description 
userid String What name should be used to broadcast. 
Msg String Broadcast message. 


7.1.3 private message 


This allows a private message to be sent to a specific user. 


Parameter Type Description 
dest uid String The receiver's userid 
msg String Message to be sent 
avatar String Avatar name in the message( could be “e1”, 
"e2" ... "e32") 
owner uid String The sender's userid 
owner nick String The sender's nickname 
b “1” or “0” 1 — bold font for the message being sent 
0 — not bold 
i “1” or “0” 1 — italic font 
0 — not italic 
u “1” or “0” 1 — underlined font 
0 — no underline 
color Hexadecimal | Color value must begin with “Ox”, eg: red is 
Number "OxFF0000" 


A full sample of this command can be seen below: 

<?xml version="1.0” encoding-"UTF-8"?» «Command group=“default” api pwdz"3874-3459- 
9293-2194" type-"private message" dest uid-'test" msg=“hello world" emotion=“e2” 
owner uid-"admin" owner nick-"admin" bz"1" i=“1” uz*1" colorz"OxffOOff" /> 

How to use above server APIs with php to send command to chat server, here is the sample 
code: 

«? 

$host = “127.0.0.1”; 

$port = 51127; 

$apiCommand = '«?xml version=“1.0” encoding=“UTF-8”?><Command group=“default” 
api_pwd=“3874-3459-9293-2194” type=“add_room” name=“Chit Chat" owner=“Mod” 
desc=“Chit Chat room.” max=“200” />'; 

$fp = fsockopen($host, $port, &$errno, &$errstr, 2); 

if(!$fp) 

{ 

echo “$errstr ($errno)n"; 

) 

else 

{ 

fputs($fp,SapiCommand.^0"); 

fclose($fp); 
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?» 


7.2 Client Parameters 


The “123flashchat.swf” can fulfill special tasks (like auto-login) by appending the parameters 
after it when inserting it into html code. 

Specific code can be generated by the dynamic web application to allow logged-in users to 
access your system. They will automatically be able to log in to any chat room without re- 
entering their name and password, etc. 


7.2.1 init_user and init_password 


With these two parameters your users do not have to re-enter their names and passwords to 
access the chat room list page as their usernames and passwords are already attached. The 
‘login’ button has already been activated. 

This provides an effective method for auto-login. 

You should be able to encrypt your user’s passwords with MD5 to make them secure. 

For example: 

If the user name = my username, password = my password, the code you should add into 
your html will be as follows: 


<script language=“javascript’> 
init userz"^myusername"; 


init password-"mypassword"; 


openSWF('123flashchat.swf','634','476'); 
</script> 
<noscript> 


<DIV idz"flashchat"» 

<OBJECT classid=“clsid:D27CDB6E-AE6D-11cf-96B8-444553540000” 
codebase=“http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version 
=6,0,19,0” WIDTHz"634" HEIGHT="476” id=“toocmm_123flashchat”> 

<PARAM NAME=movie 
VALUE="123flashchat.swf?init_user=myusername&init_password=mypassword”> 

<PARAM NAME=quality VALUE=“high’> 

<PARAM NAME-"menu" value=“false”> 

<EMBED src=“123flashchat.swf? init_user=myusername&init_password=mypassword” 
quality=high menu=false WIDTH=“634” HEIGHT="476” TYPE=“application/x-shockwave- 
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flash" PLUGINSPAGE-"http://www.macromedia.com/go/getflashplayer" scale=“noscale” 
name=“topcmm_123flashchat” swLiveConnect=“true”></EMBED> 

</OBJECT> 

</DIV> 


Note: The auto-login will not happen until both of the parameters are attached at the same 
time. 


If a user logs in as a guest, you can leave the init_password blank. This is shown in the 


following example: 


<script language=“javascript’> 
init userz"^"myusername"; 


init password-""; 


openSWF('123flashchat.swf','634','476'); 
</script> 
<noscript> 


<DIV id=“flashchat”> 

<OBJECT classid=“clsid:D27CDB6E-AE6D-11cf-96B8-444553540000” 
codebase=“http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version 
=6,0,19,0” WIDTH="634” HEIGHT="476” id=“toocmm_123flashchat’> 

<PARAM NAME=movie VALUE="“123flashchat.swf?init_user=myusername&init_password="> 
<PARAM NAME=quality VALUE=“high’> 

<PARAM NAME-"menu" value=“false”> 

«EMBED src=“123flashchat.swf? init_user=myusername&init_password=” quality=high 
menu=false WIDTH=“634” HEIGHT=“476” TYPE-"application/x-shockwave-flash" 
PLUGINSPAGE=“hitp:/Awww.macromedia.com/go/getflashplayer” scale=“noscale” 
name=“topcmm_123flashchat” swLiveConnect=“true”></EMBED> 

</OBJECT> 

</DIV> 


7.2.2 init nickname 


This parameter gives logged on users a display nickname automatically. 

It will only be valid if you set it in the server configuration as follows: 
<enable-change-nickname>On</enable-change-nickname> 

It can be used in conjunction with init_user and init_password, so that a user can have their 
own nickname once they are automatically logged in. 
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«script language-" javascript" 
init userz"myusername"; 


init password-"mypassword"; 
init nickname-"mynickname"; 


openSWF('23flashchat.swf','634', 476^); 
</script> 
<noscript> 


<DIV idz"flashchat"» 

«OBJECT classid=“clsid:D27CDB6E-AE6D-11cf-96B8-444553540000” 
codebase=“http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version 
=6,0,19,0” WIDTH="634” HEIGHT="476” id=“toocmm_123flashchat”> 
<PARAM NAME=movie 
VALUE="“123flashchat.swf?init_user=myusername&init_password=mypassword&init_nickna 
me=mynickname”> 
<PARAM NAME=quality VALUE=“high’> 
<PARAM NAME-"menu" value=“false”> 
<EMBED src="123flashchat.swf? 
init_user=myusername&init_password=mypassword &init_nickname=mynickname” 
quality=high menu=false WIDTH=“634” HEIGHT="476” TYPE=“application/x-shockwave- 
flash" PLUGINSPAGE-"http://www.macromedia.com/go/getflashplayer" scale=“noscale” 
name-"topcmm 123flashchat" swLiveConnect-"true" » «/EMBED» 
</OBJECT> 
</DIV> 


7.2.3 init root 


The init root is the string of an URL or a directory. 

It is only useful when the chat html file and the 123flashchat.swf are located in different 
directories. 

With init root, the swf can automatically load client.xml, lang folder and skin folder under the 
specified root directory: 


«script language=“javascript’> 
init rootz" http:;//www.yourhostname.com/yourdir/ “ 


openSWF('23flashchat.swf','634', 476^); 
</script> 


<noscript> 
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<DIV id-"flashchat"» 

«OBJECT classid=“clsid:D27CDB6E-AE6D-11cf-96B8-444553540000” 
codebase=“http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version 
=6,0,19,0” WIDTH="634” HEIGHT="476” id=“toocmm_123flashchat”> 
<PARAM NAME=movie VALUE=“1 23flashchat.swf?init_root= 
http://www. yourhostname.com/yourdir/"> 
<PARAM NAME=quality VALUE=“high’> 
<PARAM NAME=“menu’ value=“false”> 
«EMBED src=“123flashchat.swf?init_root= http://www.yourhostname.com/yourdir/" 
quality=high menu=false WIDTHz"634" HEIGHT="476” TYPE=“application/x-shockwave- 
flash" PLUGINSPAGE-"http://www.macromedia.com/go/getflashplayer" scale=“noscale” 
name-"topcmm 123flashchat" swLiveConnect-"true" » «/EMBED» 
</OBJECT> 
</DIV> 


Note: please add a slash at the end of this value, 
It should look like the following: 
http://www. yourhostname.com/yourdir/ 


It should NOT look like the example below: 


http://www. yourhostname.com/yourdir 


7.2.4 init room and init room pwd 


Your users can skip the room list page and automatically log directly into a specific chat room. 
Parameter "init room" can help you with auto-login-room. 


Parameter value type Description 
init room Room id number is room ID (init roomz) instead of 
room name. 
init room pwd Room string If the room is password protected, 
password you need to set init room pwd 


(init room pwdz) 
Of course init room pwd is not 
obligatory. 


For example: 


If the user name = myusername, password = mypassword, room id=1001, the code you 
should add into your html will be as follows: 


«script language-" javascript" 
init userz"^myusername"; 
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init password-"mypassword"; 
init roomz"1001"; 


openSWF('123flashchat.swf','634','476'); 
</script> 
<noscript> 


<DIV idz"flashchat"» 

<OBJECT classid=“clsid:D27CDB6E-AE6D-11cf-96B8-444553540000” 
codebase=“http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version 
=6,0,19,0” WIDTH="634” HEIGHT="476” id=“toocmm_123flashchat”> 

<PARAM NAME=movie 
VALUE="“123flashchat.swf?init_user=myusername&init_password=mypassword&init_room=1 
001”> 

<PARAM NAME=quality VALUE=“high’> 

<PARAM NAME-"menu" value=“false”> 

<EMBED src="123flashchat.swf? 
init_user=myusername&init_password=mypassword &init_room=1001” quality=high 
menu=false WIDTH=“634” HEIGHTz'476" TYPE-"application/x-shockwave-flash" 
PLUGINSPAGE=“hitp:/Awww.macromedia.com/go/getflashplayer” scale=“noscale” 
name-"topcmm 123flashchat" swLiveConnect=“true”></EMBED> 

</OBJECT> 

</DIV> 


To be effective, this parameter must be used in conjunction with the other two parameters: 
init_user and init_password. 


7.2.5 init lang 


This parameter helps the chat client to load a defined language file. 

init lang in html code will disable the language value in the client.xml because init lang has a 
higher priority. 

In this way, your dynamic web application can choose to show the local language for specific 


users in any country. 


For example: 
«script language-" javascript" 
init_lang="en”; 


openSWF('123flashchat.swf','634','476'); 
</script> 
<noscript> 
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<DIV idz"flashchat"» 

«OBJECT classid=“clsid:D27CDB6E-AE6D-11cf-96B8-444553540000” 
codebase=“http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version 
=6,0,19,0” WIDTH="634” HEIGHT="476” id=“toocmm_123flashchat”> 
<PARAM NAME=movie VALUE=“123flashchat.swf?init_lang=en”> 
<PARAM NAME=quality VALUE=“high’> 
<PARAM NAME-"menu" value=“false”> 
<EMBED src=“123flashchat.swf? init_lang=en” quality=high menu=false WIDTH=“634” 
HEIGHT=“476” TYPE-"application/x-shockwave-flash" 
PLUGINSPAGE-"http:;//www.macromedia.com/go/getflashplayer" scale=“noscale” 
name=“topcmm_123flashchat” swLiveConnect=“true”></EMBED> 
</OBJECT> 
</DIV> 


123flashchat.swf will then automatically load the language package: lang/language_en.xml 


7.2.6 init skin 


This parameter helps the flash client to load a specified skin. 

Init skin in html code will disable the skin value in the client.xml because init skin has a 
higher priority. 

In this way, your dynamic web application can ‘listen’ to each user's favorite skin. 

For example: 


«script language-" javascript" 
init skin2"default"; 


openSWF('123flashchat.swf",'634','476'); 
</script> 
<noscript> 


<DIV id=“flashchat”> 

<OBJECT classid=“clsid:D27CDB6E-AE6D-11cf-96B8-444553540000” 
codebase=“hittp://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version 
=6,0,19,0” WIDTH="634” HEIGHT="476” id=“toocmm_123flashchat’> 

<PARAM NAME=movie VALUE-"123flashchat.swf?init skin2default"» 

<PARAM NAME=quality VALUE=“high’> 

<PARAM NAME-"menu" value=“false”> 

<EMBED src=“123flashchat.swf? init_skin=default” quality=high menu=false WIDTH=“634” 
HEIGHT="476” TYPE=“application/x-shockwave-flash” 
PLUGINSPAGE=“hitp:/Awww.macromedia.com/go/getflashplayer” scale=“noscale” 
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name-"topcmm 123flashchat" swLiveConnect=“true”></EMBED> 
</OBJECT> 
</DIV> 


123flashchat.swf would then automatically load the skin under directory “ skin/classic". 


7.2.7 admin mode 


With this parameter, functions which are disabled in client.xml for ordinary users will be 
activated for the administrator. 

This will usually only need to be used in special circumstances. 

By default it is false'. 

For example: in client.xml, if you configure it to: 

«visiblePasswordlnput value=“false” /> 

then you block yourself from entering a password to enter the admin panel. 

If this is the case, with admin_mode = true, you can resolve this problem. 


You can create a special html file or dynamic webpage with this parameter to give the admin 
a control panel.For example: 


<script language=“javascript’> 
admin mode-'true"; 


openSWF('123flashchat.swf','634','476'); 
</script> 
<noscript> 


<DIV id=“flashchat”’> 

<OBJECT classid=“clsid:D27CDB6E-AE6D-11cf-96B8-444553540000” 
codebase=“http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version 
=6,0,19,0” WIDTH="634” HEIGHT="476” id=“topcmm_123flashchat’> 

<PARAM NAME=movie VALUE-"123flashchat.swf?admin mode-true" 

<PARAM NAME=quality VALUE=“high’> 

<PARAM NAME-"menu" value=“false”> 

«EMBED src=“123flashchat.swf? admin mode-true" quality=high menu=false WIDTHz"634" 
HEIGHT=“476” TYPE-"application/x-shockwave-flash" 
PLUGINSPAGE=“hitp:/Awww.macromedia.com/go/getflashplayer” scale=“noscale” 
name=“topcmm_123flashchat” swLiveConnect=“true”></EMBED> 

</OBJECT> 

</DIV> 
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7.2.8 init ad 


This will enable or disable the ‘advertisment banner’ function. 

init ad-true/false 

This parameter has a higher priority over the value of advertisingBanner in client.xml. 
For example, if in the html code you set: 


«script language-" javascript" 
init adz"true"; 


openSWF('23flashchat.swf','634',476^); 
</script> 
<noscript> 


<DIV id=“flashchat”> 

<OBJECT classid-"clsid:D27CDB6E-AE6D-11cf-96B8-444553540000" 
codebase=“http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version 
=6,0,19,0” WIDTH=“634” HEIGHT="476” id=“topcmm_123flashchat’> 

<PARAM NAME=movie VALUE=“123flashchat.swf? init ad =true”> 

<PARAM NAME=quality VALUE=“high’> 

<PARAM NAME-"menu" value=“false”> 

<EMBED src=“123flashchat.swf? init ad =true” quality=high menu=false WIDTH="634” 
HEIGHT="476” TYPE=“application/x-shockwave-flash” 
PLUGINSPAGE=“hitp:/Awww.macromedia.com/go/getflashplayer” scale=“noscale” 
name=“topcmm_123flashchat” swLiveConnect=“true”></EMBED> 

</OBJECT> 

</DIV> 


but in client.xml you set «advertisingBanner enable=“false”>. 
Then the advertisement banner will still be 'enabled'. 


7.2.9 loading bkground 


This defines whether the loading background (which is now a blue cup) appears or does not 
appear. The default value is set to ‘true’. Usually you will not need to use this interface. 

If you need a loading number without a background image, you can set the loading 
background value to ‘false’. 

For example: 


<script language=“javascript’> 
loading_bkground=false; 
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openSWF(123flashchat.swf','634','476"); 
</script> 
<noscript> 


<DIV id=“flashchat’> 

<OBJECT classid=“clsid:D27CDB6E-AE6D-11cf-96B8-444553540000” 
codebase=“hittp://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version 
=6,0,19,0” WIDTH=“634” HEIGHT="476” id=“topcmm_123flashchat”> 

<PARAM NAME=movie VALUE-"123flashchat.swf? loading_bkground =false”> 
<PARAM NAME=quality VALUE=“high’> 

<PARAM NAME-"menu" value=“false”> 

<EMBED src=“123flashchat.swf? loading_bkground -false"" quality=high menu=false 
WIDTH="634” HEIGHT=“476” TYPE=“application/x-shockwave-flash” 
PLUGINSPAGE=“hitp:/Awww.macromedia.com/go/getflashplayer” scale=“noscale” 
name=“topcmm_123flashchat” swLiveConnect=“true”></EMBED> 

</OBJECT> 

</DIV> 


7.2.10 init_private and init_private_message 


A private window can be automatically created in 123 Flash Chat with some words to start the 
conversation. This makes it perfect as a one-to-one live support software. 


Parameters "init private” and "init private message" can help you with “auto create private 


window". 
Parameter value type Description 
init private Receiver string The receiver name in the destination 
name room. 
init private message greeting string Words you would like to start with. 


For example: 


If the user name = "abc"; password = “abc”; room id = “1”; the name of the person you want to 
talk to is "test"; and you want to create a private window by saying "hello", then the script to 
add into your html code is as follows: 


«script language-" javascript" 
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init_user="myusername”; 

init password-"mypassword"; 
init roomz"1001"; 

init privatez"destusername"; 

init private message-" message"; 


openSWF('123flashchat.swf','634','476'); 
</script> 
<noscript> 


<DIV id=“flashchat”> 

<OBJECT classid=“clsid:D27CDB6E-AE6D-11cf-96B8-444553540000” 
codebase=“http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version 
26,0,19,0" WIDTH=“634” HEIGHT="476” id=“topcmm_123flashchat’> 

<PARAM NAME=movie 
VALUE=“123flashchat.swf?init_user=myusername&init_password=mypassword&init_room=1 
001 &init_private=destusername&init_private_message=message”> 

<PARAM NAME=quality VALUE=“high’> 

<PARAM NAME-"menu" value=“false”> 

<EMBED src="123flashchat.swf? 
init_user=myusername&init_password=mypassword &init_room=1001 &init_private=destusern 
ameá&init private message-message" quality=high menu=false WIDTH="634” 
HEIGHT="476” TYPE=“application/x-shockwave-flash” 
PLUGINSPAGE=“hitp:/Awww.macromedia.com/go/getflashplayer” scale=“noscale” 
name=“topcmm_123flashchat” swLiveConnect=“true”></EMBED> 

</OBJECT> 

</DIV> 


The code above will enable you to automatically log in to the chat using this account: 
username: myusername, password: mypassword. And enter the room with id “1001”. If 
someone named "destusername" already exists in that room, a private window will be 
automatically created and the message: “message” will be sent out. Of course you can 
remove the "init private message" section to cancel sending messages when creating 


private windows. 


7.2.11 Init listroom 
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"init listroom" API can be added using html code by admin to ensure that only specific rooms 
can be visible in the room list. Devide rooms using “,”. 


For example: 


«script language-" javascript" 
init listroomz"1,3,5"; 


openSWF('123flashchat.swf','634','476'); 
</script> 
<noscript> 


<DIV id=“flashchat’> 

<OBJECT classid=“clsid:D27CDB6E-AE6D-11cf-96B8-444553540000” 
codebase=“http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version 
=6,0,19,0” WIDTH="634” HEIGHT="476” id=“topcmm_123flashchat’> 

<PARAM NAME=movie VALUE=“123flashchat.swf?init_listroom=1,3,5’> 

<PARAM NAME=quality VALUE=“high’> 

<PARAM NAME-"menu" value=“false”> 

<EMBED src=“123flashchat.swf?init_listroom=1 ,3,5” quality=high menu=false WIDTH=“634” 
HEIGHT=“476” TYPE-"application/x-shockwave-flash" 
PLUGINSPAGE=“hitp:/Awww.macromedia.com/go/getflashplayer” scale=“noscale” 
name-"topcmm 123flashchat" swLiveConnect=“true”></EMBED> 

</OBJECT> 

</DIV> 


7.2.12 init_invisible 


"init. invisible" API can be added using html code by admin to set default value of admin’s 
visible. If this value is "true", admin will be set invisible as default when login. 


«script language-" javascript" 
init user-"admin"; 

init password-" admin"; 

init invisible-"true";; 


openSWF('23flashchat.swf','634', 476^); 
</script> 
<noscript> 


<DIV id=“flashchat”> 
«OBJECT classid=“clsid:D27CDB6E-AE6D- 11cf-96B8-444553540000” 


TopCMM Software 
http://www. 123flashchat.com 


123 Flash Chat User Manual 
2007-10-26 
Pages: 73 of 81 


codebase=“http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version 
=6,0,19,0” WIDTH="634” HEIGHT="476” id=“toocmm_123flashchat”> 
<PARAM NAME=movie 
VALUE-"123flashchat.swf?init usersmyusername&init password-mypasswordá&init invisible 
=true”> 
<PARAM NAME=quality VALUE=“high’> 
<PARAM NAME-"menu" value=“false”> 
<EMBED src="123flashchat.swf? 
init_user=myusername&init_password=mypassword &init_invisible=true” quality=high 
menu=false WIDTH=“634” HEIGHT=“476” TYPE-"application/x-shockwave-flash" 
PLUGINSPAGE=“hitp:/Awww.macromedia.com/go/getflashplayer” scale=“noscale” 
name=“topcmm_123flashchat” swLiveConnect=“true”></EMBED> 
</OBJECT> 
</DIV> 


7.2.13 init_group, init_host, init_port, init_host_s, init_port_s, init_host_h, 


init_port_h 


The definition of the 7 parameters 


Parameter Definition Type Default value 
init_group the group’s value String default 
init_host the primary server’s host value String i 

init port the primary server's port value Number 51127 

init host s the secondary server's host value | String id 

init port s the secondary server's port value | Number 51128 

init host h the HTTP server's host value String * 

init port h the HTTP server's port value Number 35555 


These 7 parameters are added in version 6.8.1 in order to replace the Connection and Group 
configuration originally in the client.xml which was removed there now, the admin should 
configure the 7 parameters to make the 123flashchat.swf communicate with the chat server 


properly if necessary. 


Please leave the init host, init host s and init host h value to “*” if the chat server and the web 


server (which hosts 123flashchat.swf file) are located on the same server. If the SWF file 1s on 


another web server, you should configure the init host, init host s, init host h value according 
to the chat server domain or IP address. The init port, init port s and init port h value must be 


identical with the ones in fcserver.xml. 


For details, please refer to: http://www.123flashchat.com/howto configure connection.html 
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Notice: if you are upgrading to the version 6.8.1 from the older version, don't forget to add the 7 
parameters to your HTML page which include the 123flashchat.swf file, otherwise the 
123flashchat.swf file will use the default value init_host="*”, init_port=51127 and 


init group-" default" to communication with the chat server. 


Example: 


«script language=“javascript’> 
init hostz"*"; 

init port251127; 

init host sz"*"; 

init port s-51128; 

init host hz"**; 

init port h235555; 

init group-" default"; 


openSWF('23flashchat.swf','634', 476^); 
</script> 
<noscript> 


<DIV id=“flashchat’’> 

«OBJECT classid=“clsid:D27CDB6E-AE6D- 1 1cf-96B8-444553540000” 
codebase=“‘http://download.macromedia.com/pub/shockwave/cabs/flash/swflash.cab#version=6,0, 
19,0” WIDTH=“634” HEIGHT=“476” id=“topcmm_123flashchat’’> 

<PARAM NAME=movie 
VALUE=“ 123flashchat.swf?init_host=*&init_port=5 1127&init_host_s=*&init_port_s=51128&in 
it_host_h=*&init_port_h=35555 &init_group=default’’> 

<PARAM NAME=quality VALUE=“high”> 

<PARAM NAME=“menu” value=“false’’> 
<EMBED 
src-"123flashchat.swf?init host2*&init port251127&init host s-*&init port s-51128&init ho 
st hz*&init port h235555&init group-default" quality=high menu=false WIDTH=“634” 
HEIGHT=“476” TYPE=“application/x-shockwave-flash” 
PLUGINSPAGE-"http://www.macromedia.com/go/getflashplayer" scale=“noscale” 
name=“topcmm_123flashchat” swLiveConnect=“true”></EMBED> 
</OBJECT> 
</DIV> 


8. Lite Client 


Lite version is another option for flash chat client, it is very small in file size (only about 30 kb) and 
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has the basic chat functions, including chat logo, user list, chat input area and chatbox to display 
chat content. The benefit of the lite version is that the loading speed can be faster than the 
standard flash chat client because the decoration graphics are removed. Meanwhile, the lite 
version can handle higher load, there can be about 1000 people chat at the same time in the 
same room. 


By default, the lite client will enter the first room of the chat and the user id will be generated 
automatically by the server. Or, you can use the init parameters to login and enter a room 
automatically. The parameters are: init user, init password, init nickname, init room, 

init room pwd. For the instructions, please refer to the chapter of 7.2 Client Parameters 


Sample code: 

^lite.swf?init user-a&init password-a&init room-1001, 

it indicates that you will use the username “a” and password “a” to enter the room which id is 
“1001”. 


Lite client command list: 


The send-smiley function is available in Lite Client although the Smiley Panel is removed and 
the smileys can be mixed with text in the same line. Smileys can be embedded into conversation 
via shortcut symbols, like “:)”. Tip: To check out the list of the available smileys, type command: 
"Ihelp" or "/h". The list is also illustrated in the help document of the chat client: /help/smiley- 
shortcut.htm 


If the chat owner wants to disable smiley function in lite client, use parameter init load smiley in 
html code: 
sample: lite. swf?init load smiley-false 


9. User Profile Interface 


You can customize user's profile via user profile interface. For example, it can help you show 
user's profile which is customized in database in flashchat on condition that all users' profile have 
been stored in the database of your website. 


In order to use this function, you must use the web URL to authorize user's login information, you 
can add any user's profile information next to the "login result" O(login success) or 5 (login success 
admin), and split the login result and user's profile parameter by “|”. 

When users login, there is an attribute ‘c’ with the login user's profile information carried at the 
head of login element from server to client. When users enter room or change room, there is an 
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attribute 'c' with another user's profile information carried at the head of u element from server to 
client. 


Example: 

login chat.php 

<? 
$username-$ GET[username"; 
$password-$ GET[password'; 


ifSusername--"owen"&&$password--"owen") 


{ 
echo '5|gender=mé&age1=23&avaURL=http://www. 123flashchat.com/a.jpg’; 
} 
else 
{ 
echo '0|gender=m&age1=28&avaURL=http://1 www. 123flashchat.com/b.jpg'; 
} 
?» 


When user(owen) login: (returned xml from server to client) 


«Login cnz"1" Inz*1" cto=“20” kat=“300” ito="300” eur=“1” egl=“1” smh="1" espumh="1” 
esprmh="1” rmm="1” eec=“1” mt=“0” puurl=“message” pufnz"public" 

c=“gender=mé&amp;agel =23&amp;avaURL=hitp://www. 123flashchat.com/a.jpg”(owen’s profile) 
result="5" ecp="1” ecnz*1" mml=“256” mprz*5" ebl=“1”><Userlnfo><UserProfile n=“owen” 

l=“ az"-1" sz"" /><TalkMsg b=“0” uz"0" i=“0” colorz"" fontSize="0” /></Userlnfo></Login> 


When user(owen) enter room: (returned xml from server to client) 


«Enter id="1” ct=“1 162281026218” result="0"” passMessage="“true” name=“Default Room" 
ez"1"»«u name="“bell” avatar=“e1” nickname="“bell” 

c=“gender=m&amp;agel =28&amp;avaURL=nhttp://1 www. 123flashchat.com/b.jpg”(bell’s profile) 
chatmode=“1” p=“192.168.0.100(Unknown)”><UserProfile n=“bell” l=“ a=*-1” s=“* /></u><u 
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namez"owen" a="1” avatar=“e1” nickname=“owen” 

c=“gender=m&amp;agel =23&amp;avaURL=http://www. 1 23flashchat.com/a.jpg”(owen’s profile) 
chatmode="1” p="“192.168.0.100(Unknown)”><UserProfile nz*owen" l=“ az"-1" 

sz" /></u></Enter> 


10. Cross Proxy 


Cross Proxy function ensure client can connect to the chat server when user accessing 
Internet via a proxy server. 


Before you reading the configuration content, please do following preparation: 

1. Make sure your 123flashchat version is at least 6.3. 

2. Make sure you have at least one available Public IP Address on your Computer which installed 
the 123 flash chat server. (IP Address is an identifier for a computer or device on a TCP/IP network.). 

3. Prepare an available network port with this Public IP Address (An available network port 
means this port is not used by any network program by this Public IP Address. Port range: 1~65535) 

4. Prepare an available Domain Name binding with your Public IP Address. 

(Domain Name and IP Address WHOIS pages can be directly accessed by pointing your browser 
to www.123flashchat.com or 222.66.76.76.) 

You should must ensure the Domain Name that can access the web page embedded the 
123flashchat.swf and the Domain Name you prepared share the same domain suffix. 


Example: 


Web page embedded the 123flashchat.swf: 
Domain Name: www.123flashchat.com 

IP Address: 222.66.76.76 

Port: 80 

You prepared: 

Domain Name: chat.123flashchat.com 

IP Address: 222.77.77.77 


Port: 80 
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The domain name that can access the web page embedded the 123flashchat.swf is : 
www.123flashchat.com 


The domain name you have prepared is: chat.123flashchat.com 


They share the same domain suffix “123flashchat.com’, so this is ok. 


Web page embedded the 123flashchat.swf: 
Domain Name: www.123flashchat.com 

IP Address: 222.66.76.76 

Port: 80 

You prepared: 

Domain Name: www.123flashchat.com 

IP Address: 222.66.76.76 

Port: 35555 


The domain name that can access the web page embedded the 123flashchat.swf is : 
www. 123flashchat.com:80 


The domain name you have prepared is: www.123flashchat.com:35555 


They share the same domain suffix “123flashchat.com’, so this is ok. 


Web page embedded the 123flashchat.swf: 
Domain Name: www.123flashchat.com 
IP Address: 222.66.76.76 
Port: 80 
You prepared: 
Domain Name: www.123livehelp.com 
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IP Address: 222.77.77.77 
Port: 80 


The domain name that can access the web page embedded the 123flashchat.swf is : 
www.123flashchat.com 


The domain name you have prepared is: www.123livehelp.com 
One of the domain suffix is “123flashchat.com”, and the other is *123livehelp.com" 


They are not share the same domain suffix, so this is not allowed. 


10.1 Configuration: 
In order to make the cross proxy function working, you should edit following file. 
1. fcserver.xml located on «123flashchat installed directory>/server/etc/fcserver.xml 


2. client.xml located on «123flashchat installed 
directory>/server/etc/groups/default/client.xml 


3. proxy.js located on <123flashchat installed directory»/client/proxy.js 
Step 1: 
Edit fcserver.xml 


Find this sentence "«http-server ip=“*” port="85555” enable-"On"» «/http-server»" in 
fcserver.xml 


This configuration is used to make the chat server starting a http server to ensure the 
client can communicate with the chat server via http protocol when user accessing Internet 
through a proxy. 


Set the ip value with your prepared Public IP Address, and set the port value with your 
prepared Port. And restart your chat server. 


Step 2: 
Edit html page which includes the 123flashchat.swf 
Set 


init host h-"your prepared Domain Name" and init port h-" your prepared Port" between 
the «script» and </script> tag. 
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This configuration is used to make the client can connect to chat http server. 
Step 3: 

Edit proxy.js 

Find the variable *my domain" 

Set this variable to your prepared domain suffix 

Example: 

Prepared Domain: chat.123flashchat.com 

Then domain suffix=123flashchat.com 


So set variable my domainz"123flashchat.com" 


Sample: 

Your preparation: 

Domain Name: chat.123flashchat.com 
Domain suffix: 123flashchat.com 

IP Address: 222.77.77.77 


Port: 80 


Step1: Open fcserver.xml 


deem 


Step 2: Edit “<http-server ip=“*” port="85555” enable=“On’></http-server>* with 
«http-server ip="222.77.77.77” port="80" enablez"On"»«/htp-server»" 

Step 3: Restart the chat server 

Step 4: Open the html page which includes the 123flashchat.swf file 


Step 5: 


Set the init host h-"chat.123flashchat.com" and the init port h280 between the <script> 
and </script> tag. 
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Step 6: Open proxy.js 
Step 7: Set the variable my domainz"123flashchat.com" 


Congratulation, you have completed all configuration! 


-- The END -- 
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